Projects

Delete a project

Permanently deletes the project and its backing runtime project. Fails with 409 if the runtime project still has dependent resources — remove them first, or pass force=true to delete the project and all its dependents (agents, providers, tools, sessions, generations, traces). Forcing is destructive and irreversible. Requires the owner role — an admin runs the project day to day, but destroying it is the billing owner's call. The project's spend so far is settled on the owner's balance first, and its runs this cycle stay on the owner's run allowance and statement.

delete/v1/projects/{project_id}

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

forceboolean

When true, delete the resource together with its dependents instead of returning 409. Destructive and irreversible.

Response

Project deleted.

Changes

No recorded changes to this operation across all 1 revision of this API.