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. The managed conversion rules every project is created with are not dependents: they are removed with the project.
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.
Request
Responses
- 204
- 401
- 403
- 404
- 409
- 502
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).
The project's usage could not be read to settle it before the delete (UPSTREAM_UNAVAILABLE); nothing was deleted.