Skip to main content
POST
Confirm a proposed edit (apply it)
Second step of the propose → confirm flow. See Propose an agent edit for the full walkthrough, with a complete request/response example.

Authorizations

Authorization
string
header
required

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

Headers

If-Match
string
required

The baseUpdatedAt returned by proposeAssistantEdits (the assistant's updated_at the anchors resolved against). Required: omitting it answers 428 PRECONDITION_REQUIRED with the guidance to send the propose's baseUpdatedAt. 412 = stale: re-read the assistant and re-run proposeAssistantEdits.

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

Body

application/json

Just the confirmationId returned by proposeAssistantEdits.

The confirmationId returned by propose-edits — the only field this endpoint reads.

confirmationId
string
required

Confirmation token returned by propose-edits; required. The server re-applies the proposal it stored for this token (send If-Match=baseUpdatedAt as a header).

Response

The persisted agent, in the same stubbed passthrough shape getAssistant returns.

Free-form object: the agent's stored configuration, in whatever shape the live config schema for its deployment accepts. Read the keys you need; do not assume a fixed set.