Create agent

POST

/api/agents

Creates a new voice agent for the authenticated tenant. Unspecified fields fall back to documented defaults. Recording and silent recording cannot both be enabled at once.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201Success

application/json

Agent created.

Bodyapplication/json

🟠400ValidationError

🟠401Unauthorized

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/agents' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Support Agent",
    "instructions": "You are a friendly customer support assistant for Example AS. Answer questions clearly and politely.",
    "voice": "marin",
    "temperature": 0.8,
    "recording_enabled": false,
    "silent_recording_enabled": false,
    "greeting_message": "Hei, hvordan kan jeg hjelpe deg?",
    "greeting_speaks_first": true,
    "transfer_enabled": false,
    "vad_type": "server_vad",
    "knowledge_base_enabled": false,
    "allowed_embed_domains": [
        "example.com"
    ],
    "human_handoff_enabled": false,
    "avatar_enabled": false,
    "avatar_provider": "anam"
}'

Response Example

201 - Example 1

{
    "agent": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string",
        "description": "string",
        "instructions": "string",
        "voice": "string",
        "language": "string",
        "model": "string",
        "phone_number": "string",
        "is_active": true,
        "mode": "prompt",
        "greeting_message": "string",
        "transfer_enabled": true,
        "transfer_number": "string",
        "knowledge_base_enabled": true,
        "chat_enabled": true,
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-07-08 19:01:40

List agents

Get agent