curl --request POST \
  --url https://api.kallabot.com/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "config": {
    "name": "Inline agent",
    "prompt": "You are a friendly voice assistant on a phone call.",
    "greeting": "Hi! How can I help?",
    "outbound_greeting": "<string>",
    "purpose": "<string>",
    "language": "en",
    "timezone": "<string>",
    "stt": {
      "provider": "<string>",
      "model": "<string>",
      "language": "<string>",
      "languages": [
        "<string>"
      ],
      "strict_language": true,
      "context": {
        "general": {
          "domain": "Dental clinic",
          "location": "Dubai",
          "setting": "Phone booking"
        },
        "text": "<string>",
        "terms": [
          "Invisalign",
          "Dr Al Mansouri",
          "root canal"
        ]
      },
      "language_identification": true,
      "language_focus": true,
      "endpointing": {
        "latency_level": 1,
        "sensitivity": 0,
        "max_delay_ms": 1750
      },
      "diarization": true,
      "addressivity": "retain",
      "perception": true,
      "speaker_embeddings": false,
      "speaker_embedding_model": "<string>",
      "speaker_embedding_threshold": 0.5,
      "acoustics": true,
      "clarify_below": 0.5,
      "ignore_below": 0.5,
      "keywords": [
        "<string>"
      ]
    },
    "llm": {
      "provider": "<string>",
      "model": "<string>",
      "temperature": 1,
      "max_tokens": 2048,
      "top_p": 0.5,
      "frequency_penalty": 0,
      "presence_penalty": 0,
      "seed": 123,
      "extra": {
        "reasoning_effort": "none"
      },
      "fallback": {
        "provider": "<string>",
        "model": "<string>"
      }
    },
    "tts": {
      "provider": "<string>",
      "model": "<string>",
      "voice": "<string>",
      "language": "<string>",
      "speed": 1.05,
      "volume": 1.25,
      "temperature": 1,
      "stability": 0.5,
      "emotion": "<string>",
      "pronunciation_dict_id": "<string>",
      "max_buffer_delay_ms": 2500,
      "steering": true,
      "non_verbals": true,
      "backchanneling": true,
      "backchannel_start_delay_sec": 10.5,
      "backchannel_gap_sec": 16,
      "backchannel_max_per_minute": 3
    },
    "turn": {
      "max_wait_sec": 5.3,
      "pre_speech_ms": 1000,
      "claim_secs": 0.85,
      "ringback_settle_sec": 1.05,
      "resume_short_sec": 15.25,
      "resume_long_sec": 30.25,
      "confidence": 0.5,
      "min_volume": 0.5,
      "stop_secs": 0.55,
      "interruptible": true,
      "min_interrupt_words": 5,
      "protect_greeting": true,
      "idle_timeout_sec": 60
    },
    "style": {
      "disfluency": true,
      "avoid_tells": true,
      "backchanneling": true,
      "backchannel_start_delay_sec": 10.5,
      "backchannel_gap_sec": 16,
      "backchannel_max_per_minute": 5,
      "lookup_cut_in": true
    },
    "audio": {
      "crowded_places": true,
      "ambient": {
        "volume": 0.5
      },
      "wideband": true
    },
    "call": {
      "max_duration_sec": 3605,
      "record": true,
      "summarize_long_calls": true,
      "end_call": true,
      "voicemail": {
        "enabled": false,
        "message": "<string>"
      },
      "transfer": {
        "enabled": true,
        "destinations": [
          {
            "id": "<string>",
            "label": "<string>",
            "to": "<string>",
            "description": "<string>",
            "mode": "cold",
            "caller_message": "<string>",
            "consultation_message": "<string>",
            "timeout_sec": 30
          }
        ],
        "failure_message": "<string>"
      },
      "monitoring_notice": {
        "enabled": true,
        "text": "<string>"
      }
    },
    "memory": {
      "enabled": true,
      "retention_days": 1825
    },
    "knowledge": {
      "ids": [
        "<string>"
      ],
      "top_k": 10,
      "channels": {}
    },
    "tools": [
      {
        "tool_id": "<string>",
        "channels": [],
        "allowed_tools": [
          "<string>"
        ],
        "overrides": {
          "filler": "<string>",
          "filler_after_ms": 5000,
          "timeout_ms": 15050
        },
        "name": "<string>",
        "description": "<string>",
        "url": "<string>",
        "headers": {},
        "auth": {
          "type": "none",
          "credential_id": "<string>",
          "token": "<string>",
          "header": "<string>",
          "query": "<string>",
          "value": "<string>",
          "sealed": "<string>",
          "hint": "<string>"
        },
        "parameters": {},
        "timeout_ms": 15050,
        "blocking": true,
        "filler": "<string>"
      }
    ],
    "builtins": {
      "knowledge_search": true,
      "calendar": {
        "google_connection_id": "<string>",
        "calendar_id": "primary",
        "timezone": "<string>",
        "duration_min": 30,
        "hours": [
          {
            "start": "<string>",
            "end": "<string>"
          }
        ],
        "min_notice_min": 60
      },
      "sheets": {
        "google_connection_id": "<string>",
        "spreadsheet_id": "<string>",
        "sheet": "",
        "when": ""
      },
      "whatsapp_send": {
        "connection_id": "<string>"
      },
      "email_send": true
    },
    "analysis": {
      "successDefinition": "<string>",
      "dispositionLabels": [
        "<string>"
      ],
      "bookingToolIds": [
        "<string>"
      ],
      "extractFields": [
        {
          "key": "<string>",
          "type": "string",
          "description": ""
        }
      ]
    },
    "web_search": {
      "enabled": true,
      "max_results": 5,
      "domains": [
        "<string>"
      ],
      "max_per_call": 3,
      "provider": "<string>"
    },
    "metadata": {}
  }
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    config: {
      name: 'Inline agent',
      prompt: 'You are a friendly voice assistant on a phone call.',
      greeting: 'Hi! How can I help?',
      outbound_greeting: '<string>',
      purpose: '<string>',
      language: 'en',
      timezone: '<string>',
      stt: {
        provider: '<string>',
        model: '<string>',
        language: '<string>',
        languages: ['<string>'],
        strict_language: true,
        context: {
          general: {domain: 'Dental clinic', location: 'Dubai', setting: 'Phone booking'},
          text: '<string>',
          terms: ['Invisalign', 'Dr Al Mansouri', 'root canal']
        },
        language_identification: true,
        language_focus: true,
        endpointing: {latency_level: 1, sensitivity: 0, max_delay_ms: 1750},
        diarization: true,
        addressivity: 'retain',
        perception: true,
        speaker_embeddings: false,
        speaker_embedding_model: '<string>',
        speaker_embedding_threshold: 0.5,
        acoustics: true,
        clarify_below: 0.5,
        ignore_below: 0.5,
        keywords: ['<string>']
      },
      llm: {
        provider: '<string>',
        model: '<string>',
        temperature: 1,
        max_tokens: 2048,
        top_p: 0.5,
        frequency_penalty: 0,
        presence_penalty: 0,
        seed: 123,
        extra: {reasoning_effort: 'none'},
        fallback: {provider: '<string>', model: '<string>'}
      },
      tts: {
        provider: '<string>',
        model: '<string>',
        voice: '<string>',
        language: '<string>',
        speed: 1.05,
        volume: 1.25,
        temperature: 1,
        stability: 0.5,
        emotion: '<string>',
        pronunciation_dict_id: '<string>',
        max_buffer_delay_ms: 2500,
        steering: true,
        non_verbals: true,
        backchanneling: true,
        backchannel_start_delay_sec: 10.5,
        backchannel_gap_sec: 16,
        backchannel_max_per_minute: 3
      },
      turn: {
        max_wait_sec: 5.3,
        pre_speech_ms: 1000,
        claim_secs: 0.85,
        ringback_settle_sec: 1.05,
        resume_short_sec: 15.25,
        resume_long_sec: 30.25,
        confidence: 0.5,
        min_volume: 0.5,
        stop_secs: 0.55,
        interruptible: true,
        min_interrupt_words: 5,
        protect_greeting: true,
        idle_timeout_sec: 60
      },
      style: {
        disfluency: true,
        avoid_tells: true,
        backchanneling: true,
        backchannel_start_delay_sec: 10.5,
        backchannel_gap_sec: 16,
        backchannel_max_per_minute: 5,
        lookup_cut_in: true
      },
      audio: {crowded_places: true, ambient: {volume: 0.5}, wideband: true},
      call: {
        max_duration_sec: 3605,
        record: true,
        summarize_long_calls: true,
        end_call: true,
        voicemail: {enabled: false, message: '<string>'},
        transfer: {
          enabled: true,
          destinations: [
            {
              id: '<string>',
              label: '<string>',
              to: '<string>',
              description: '<string>',
              mode: 'cold',
              caller_message: '<string>',
              consultation_message: '<string>',
              timeout_sec: 30
            }
          ],
          failure_message: '<string>'
        },
        monitoring_notice: {enabled: true, text: '<string>'}
      },
      memory: {enabled: true, retention_days: 1825},
      knowledge: {ids: ['<string>'], top_k: 10, channels: {}},
      tools: [
        {
          tool_id: '<string>',
          channels: [],
          allowed_tools: ['<string>'],
          overrides: {filler: '<string>', filler_after_ms: 5000, timeout_ms: 15050},
          name: '<string>',
          description: '<string>',
          url: '<string>',
          headers: {},
          auth: {
            type: 'none',
            credential_id: '<string>',
            token: '<string>',
            header: '<string>',
            query: '<string>',
            value: '<string>',
            sealed: '<string>',
            hint: '<string>'
          },
          parameters: {},
          timeout_ms: 15050,
          blocking: true,
          filler: '<string>'
        }
      ],
      builtins: {
        knowledge_search: true,
        calendar: {
          google_connection_id: '<string>',
          calendar_id: 'primary',
          timezone: '<string>',
          duration_min: 30,
          hours: [{start: '<string>', end: '<string>'}],
          min_notice_min: 60
        },
        sheets: {
          google_connection_id: '<string>',
          spreadsheet_id: '<string>',
          sheet: '',
          when: ''
        },
        whatsapp_send: {connection_id: '<string>'},
        email_send: true
      },
      analysis: {
        successDefinition: '<string>',
        dispositionLabels: ['<string>'],
        bookingToolIds: ['<string>'],
        extractFields: [{key: '<string>', type: 'string', description: ''}]
      },
      web_search: {
        enabled: true,
        max_results: 5,
        domains: ['<string>'],
        max_per_call: 3,
        provider: '<string>'
      },
      metadata: {}
    }
  })
};

fetch('https://api.kallabot.com/v1/agents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.kallabot.com/v1/agents"

payload = { "config": {
        "name": "Inline agent",
        "prompt": "You are a friendly voice assistant on a phone call.",
        "greeting": "Hi! How can I help?",
        "outbound_greeting": "<string>",
        "purpose": "<string>",
        "language": "en",
        "timezone": "<string>",
        "stt": {
            "provider": "<string>",
            "model": "<string>",
            "language": "<string>",
            "languages": ["<string>"],
            "strict_language": True,
            "context": {
                "general": {
                    "domain": "Dental clinic",
                    "location": "Dubai",
                    "setting": "Phone booking"
                },
                "text": "<string>",
                "terms": ["Invisalign", "Dr Al Mansouri", "root canal"]
            },
            "language_identification": True,
            "language_focus": True,
            "endpointing": {
                "latency_level": 1,
                "sensitivity": 0,
                "max_delay_ms": 1750
            },
            "diarization": True,
            "addressivity": "retain",
            "perception": True,
            "speaker_embeddings": False,
            "speaker_embedding_model": "<string>",
            "speaker_embedding_threshold": 0.5,
            "acoustics": True,
            "clarify_below": 0.5,
            "ignore_below": 0.5,
            "keywords": ["<string>"]
        },
        "llm": {
            "provider": "<string>",
            "model": "<string>",
            "temperature": 1,
            "max_tokens": 2048,
            "top_p": 0.5,
            "frequency_penalty": 0,
            "presence_penalty": 0,
            "seed": 123,
            "extra": { "reasoning_effort": "none" },
            "fallback": {
                "provider": "<string>",
                "model": "<string>"
            }
        },
        "tts": {
            "provider": "<string>",
            "model": "<string>",
            "voice": "<string>",
            "language": "<string>",
            "speed": 1.05,
            "volume": 1.25,
            "temperature": 1,
            "stability": 0.5,
            "emotion": "<string>",
            "pronunciation_dict_id": "<string>",
            "max_buffer_delay_ms": 2500,
            "steering": True,
            "non_verbals": True,
            "backchanneling": True,
            "backchannel_start_delay_sec": 10.5,
            "backchannel_gap_sec": 16,
            "backchannel_max_per_minute": 3
        },
        "turn": {
            "max_wait_sec": 5.3,
            "pre_speech_ms": 1000,
            "claim_secs": 0.85,
            "ringback_settle_sec": 1.05,
            "resume_short_sec": 15.25,
            "resume_long_sec": 30.25,
            "confidence": 0.5,
            "min_volume": 0.5,
            "stop_secs": 0.55,
            "interruptible": True,
            "min_interrupt_words": 5,
            "protect_greeting": True,
            "idle_timeout_sec": 60
        },
        "style": {
            "disfluency": True,
            "avoid_tells": True,
            "backchanneling": True,
            "backchannel_start_delay_sec": 10.5,
            "backchannel_gap_sec": 16,
            "backchannel_max_per_minute": 5,
            "lookup_cut_in": True
        },
        "audio": {
            "crowded_places": True,
            "ambient": { "volume": 0.5 },
            "wideband": True
        },
        "call": {
            "max_duration_sec": 3605,
            "record": True,
            "summarize_long_calls": True,
            "end_call": True,
            "voicemail": {
                "enabled": False,
                "message": "<string>"
            },
            "transfer": {
                "enabled": True,
                "destinations": [
                    {
                        "id": "<string>",
                        "label": "<string>",
                        "to": "<string>",
                        "description": "<string>",
                        "mode": "cold",
                        "caller_message": "<string>",
                        "consultation_message": "<string>",
                        "timeout_sec": 30
                    }
                ],
                "failure_message": "<string>"
            },
            "monitoring_notice": {
                "enabled": True,
                "text": "<string>"
            }
        },
        "memory": {
            "enabled": True,
            "retention_days": 1825
        },
        "knowledge": {
            "ids": ["<string>"],
            "top_k": 10,
            "channels": {}
        },
        "tools": [
            {
                "tool_id": "<string>",
                "channels": [],
                "allowed_tools": ["<string>"],
                "overrides": {
                    "filler": "<string>",
                    "filler_after_ms": 5000,
                    "timeout_ms": 15050
                },
                "name": "<string>",
                "description": "<string>",
                "url": "<string>",
                "headers": {},
                "auth": {
                    "type": "none",
                    "credential_id": "<string>",
                    "token": "<string>",
                    "header": "<string>",
                    "query": "<string>",
                    "value": "<string>",
                    "sealed": "<string>",
                    "hint": "<string>"
                },
                "parameters": {},
                "timeout_ms": 15050,
                "blocking": True,
                "filler": "<string>"
            }
        ],
        "builtins": {
            "knowledge_search": True,
            "calendar": {
                "google_connection_id": "<string>",
                "calendar_id": "primary",
                "timezone": "<string>",
                "duration_min": 30,
                "hours": [
                    {
                        "start": "<string>",
                        "end": "<string>"
                    }
                ],
                "min_notice_min": 60
            },
            "sheets": {
                "google_connection_id": "<string>",
                "spreadsheet_id": "<string>",
                "sheet": "",
                "when": ""
            },
            "whatsapp_send": { "connection_id": "<string>" },
            "email_send": True
        },
        "analysis": {
            "successDefinition": "<string>",
            "dispositionLabels": ["<string>"],
            "bookingToolIds": ["<string>"],
            "extractFields": [
                {
                    "key": "<string>",
                    "type": "string",
                    "description": ""
                }
            ]
        },
        "web_search": {
            "enabled": True,
            "max_results": 5,
            "domains": ["<string>"],
            "max_per_call": 3,
            "provider": "<string>"
        },
        "metadata": {}
    } }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "<string>",
  "name": "<string>",
  "slug": "<string>",
  "status": "draft",
  "direction": "inbound",
  "revision": 123,
  "has_unpublished_changes": true,
  "total_calls": 123,
  "created_at": "<string>",
  "updated_at": "<string>",
  "capabilities": {
    "can_edit": true,
    "can_publish": true,
    "can_archive": true,
    "can_call": true
  },
  "config": {},
  "config_hash": "<string>",
  "schema_version": 123,
  "published_version": 123,
  "draft_version": 123,
  "owner_user_id": "<string>",
  "team_id": "<string>",
  "tags": [
    "<string>"
  ],
  "last_call_at": "<string>",
  "findings": [
    {
      "severity": "error",
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "provider": "<string>"
    }
  ]
}

{
  "type": "https://docs.kallabot.com/errors/unsupported_api_version",
  "title": "Kallabot-Version names a version this API doesn't have",
  "status": 400,
  "code": "unsupported_api_version",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/unauthenticated",
  "title": "Missing or invalid API key",
  "status": 401,
  "code": "unauthenticated",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/insufficient_scope",
  "title": "The key lacks a required scope",
  "status": 403,
  "code": "insufficient_scope",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/revision_conflict",
  "title": "Conflicts with the resource's current state",
  "status": 409,
  "code": "revision_conflict",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/invalid_request",
  "title": "One or more fields are not valid",
  "status": 422,
  "code": "invalid_request",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/sdk_version_unsupported",
  "title": "This SDK release is switched off: upgrade the SDK",
  "status": 426,
  "code": "sdk_version_unsupported",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/precondition_required",
  "title": "A required header is missing (Idempotency-Key or If-Match)",
  "status": 428,
  "code": "precondition_required",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "retryable": true
}

{
  "type": "https://docs.kallabot.com/errors/internal_error",
  "title": "Something went wrong on our side",
  "status": 500,
  "code": "internal_error",
  "retryable": true
}