API Reference
Agents

Delete an agent draft

DELETE
/v1/agents/{id}

Requires a writer role. 409 if a running broadcast still uses the agent.

Authorization

bearerAuth
AuthorizationBearer <token>

Long-lived ES256 JWT minted from the dashboard (https://app.sautikit.com/developers/api-keys). Signed by the platform keyring. Carries workspace_id and scopes claims; revoked via the platform deny-list.

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string"  }}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string"  }}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string"  }}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string"  }}

Update an agent draft PUT

Full-body update of the mutable draft (published revisions are immutable). Requires a writer role.

Publish the current draft as an immutable revision POST

Freezes the draft as revision N+1 (prompt, voice config, model with a pinned version, and a snapshot of the tools) and emits the `agent.published` event. Requires a writer role. No request body.