Skip to main content
PUT
Save Agent Draft

Authorizations

Authorization
string
header
required

The access_token returned by POST /apikeys/token for an API key's secret.

Path Parameters

agent_id
string
required

Query Parameters

Body

application/json
spec
AgentSpec · object
required

An agent as the builder shapes it: the configuration plus guardrails and the reasons behind each section. The runtime switches the guardrails imply are derived here so the document and the guardrails never disagree.

expected_revision
integer | null
design_history_append
DesignLogEntry · object[] | null

Response

Successful Response

draft
AgentDraft · object
required

The unpublished working copy of an agent.

checks
Check · object[]