Agents
Get one agent draft
Never includes the signing secret (shown once, on create/rotate only).
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
Format
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "base_prompt": "string", "accent": "string", "speech_style": "string", "voice": "string", "model": "string", "max_call_minutes": 0, "status": "string", "current_revision": 0, "tool_count": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string" }}Create an agent draft POST
Creates a draft agent. The response is the ONE read that includes `tool_signing_secret` — store it immediately; it is never returned again (rotate via the dashboard if lost).
Update an agent draft PUT
Full-body update of the mutable draft (published revisions are immutable). Requires a writer role.