Delete a project

DELETE 
/api/v1/projects/:project_id

Deletes a project. Requires admin role. Fails with 409 if the project has any dependent resource, unless force=true is passed, in which case those resources are deleted along with the project.

Every project-scoped resource counts: agents, ai providers, model routes, tools, ingestion rules, actors, chats, conversations, sessions, generations, traces, datasets, evals, workflows, tasks, triggers, orchestrations and their runs, formations, memories, secrets, files, guardrails, quotas, usage history — and the activity, approval, exception and guardrail-evaluation records a project accumulates while it runs. Audit log entries are the one exception: they outlive the project, keeping their record with project_id cleared.

Request

Responses

204

Project deleted successfully

401

Unauthorized

403

Forbidden (non-admin user)

404

Project not found

409

Project has dependent resources (pass force=true to delete anyway)