Delete a project
DELETE/v1/projects/:project_id
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.
Request
Responses
- 204
- 401
- 403
- 404
- 409
Project deleted.
Missing or invalid credentials.
The credential is scoped to a different project, or the caller's role in the project does not carry this action.
The resource does not exist (existence is not leaked).
The project still has dependent resources on the runtime (retry with force=true).