Beta

Voice agents API

Create stored agents with POST /v1/agents — persona, voice and call settings — and start calls by id.

Voice agents

Stored agents carry the prompt, voice, greeting and call settings, so every call names an id instead of recomposing configuration. Owner-scoped: GET /v1/agents lists yours; PATCH and DELETE act on /v1/agents/{agent_id}.

POST /v1/agents

namestring

Display name, 1–80 characters.

system_promptstring

The agent's full persona — what it is and how it speaks.

first_messagestring?

Spoken verbatim as the agent's first turn.

voice_idstring?

A voice id from GET /v1/voices the agent speaks with.

settingsobject?

Agent-level defaults: turn detection, patience, max_duration_seconds (10–3600), recording, backchannel.

Field	Type	Notes
name	string	Display name, 1–80 characters.
system_prompt	string	The agent's full persona — what it is and how it speaks.
first_message	string?	Spoken verbatim as the agent's first turn.
voice_id	string?	A voice id from GET /v1/voices the agent speaks with.
settings	object?	Agent-level defaults: turn detection, patience, max_duration_seconds (10–3600), recording, backchannel.

GET /v1/agents

PATCH /v1/agents/{agent_id}

DELETE /v1/agents/{agent_id}

curl -X POST https://api.sawtakarabi.ai/v1/agents \  -H "Authorization: Bearer $SAWTAK_API_KEY" \  -H "Content-Type: application/json" \  -d '{"name": "أم العجلان", "system_prompt": "أنت راوية حكايات…", "voice_id": "<voice_id>"}'