projects.delete

Soft-delete a project (recoverable via support).

Delete a BlueForge platform project. The project is soft-deleted and can be recovered by contacting support within 30 days.

Endpoint

/api/platform/projects/:id

Parameters

id

prj_*

Response

interface DeleteResult {
  id: string
  deleted_at: string
  recoverable_until: string
}

Examples

cURL:

curl -X DELETE https://api.blueforge.studio/api/platform/projects/prj_xxxxx \
  -H "Authorization: Bearer $BF_API_KEY"

SDK:

import { Client } from "@blueforge/client"
const client = new Client({ apiKey: process.env.BF_API_KEY! })
const result = await client.projects.delete("prj_xxxxx")
console.log(result.deleted_at)

CLI:

forge project delete prj_xxxxx

Pitfalls

• Soft delete only — data is not immediately purged. Hard deletion requires support ticket.
• Recovery window — 30 days. After that, data is permanently removed.
• Cascading deletes — all project resources (DB, storage, API keys) are deactivated on delete.
• Active deployments — all running app deployments for the project are stopped.

See also

{auto-injected}

Tested against

{auto-injected}