Skip to main content
DELETE
Delete a draft agent
409 covers three distinct causes: the agent is not a draft (only drafts can be deleted); a draft supervisor referencing this agent is being edited right now and holds its lease (retry shortly); or this draft is referenced by an agent this API cannot modify — a published supervisor, or one in a project outside your token (remove the reference in the ClaudIA app first).

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

tenant
string
required

Tenant whose agents you are managing. Discover the tenants your credentials cover with listMyClaudiaProjects. A tenant your credentials do not cover is indistinguishable from one that does not exist.

id
string
required

Assistant to operate on, as returned by listAssistants (assistant_id field).

Query Parameters

role
enum<string>
required

Deployment the assistant lives in: supervisor (orchestrator agents) or react (specialist agents), plus qna for knowledge-base Q&A agents. Read them with that role; they are CREATED through proposeAssistantCreate as deployment: react with graphId: qna_agent, and the platform derives the qna role from the graph. listAssistants returns it as deployment_role on each row — pass that value back here verbatim. A qna agent follows the same draft rule as any other: only a draft accepts writes, and a published one answers 409 naming its draft.

Available options:
supervisor,
react,
qna

Response

The draft was deleted.