Skip to main content
POST
/
test_framework
/
v2
/
aiagents
Create an AI voice agent
curl --request POST \
  --url https://api.cekura.ai/test_framework/v2/aiagents/ \
  --header 'Content-Type: application/json' \
  --header 'X-CEKURA-API-KEY: <api-key>' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "project": 123,
  "language": "en",
  "telephony": {
    "phone_number": "<string>",
    "inbound": false,
    "sip_uri": "<string>",
    "sip_auth": "<unknown>",
    "outbound_numbers": [
      "<string>"
    ]
  },
  "provider": {
    "agent_id": "<string>",
    "credentials": {
      "api_key": "<string>",
      "config": {
        "public_key": "<string>",
        "trigger_url": "<string>"
      }
    },
    "chat_agent_details": {
      "config": {
        "agent_id": "<string>"
      }
    },
    "auto_dial_outbound": true,
    "auto_import_calls": true,
    "auto_sync_prompt": true,
    "send_post_conversation_metadata": true
  },
  "agent_speaks_first": true,
  "predefined_metrics": "<unknown>",
  "webhook_url": "<string>",
  "webhook_secret": "<string>"
}
'
{
  "name": "<string>",
  "description": "<string>",
  "id": 123,
  "project": 123,
  "language": "en",
  "telephony": {
    "phone_number": "<string>",
    "inbound": false,
    "sip_uri": "<string>",
    "sip_auth": "<unknown>",
    "outbound_numbers": [
      "<string>"
    ]
  },
  "provider": {
    "agent_id": "<string>",
    "credentials": {
      "config": {
        "public_key": "<string>",
        "trigger_url": "<string>"
      }
    },
    "chat_agent_details": {
      "config": {
        "agent_id": "<string>"
      }
    },
    "auto_dial_outbound": true,
    "auto_import_calls": true,
    "auto_sync_prompt": true,
    "send_post_conversation_metadata": true
  },
  "agent_speaks_first": true,
  "knowledge_base_files": "<string>",
  "enabled_personalities": [
    123
  ],
  "webhook_url": "<string>",
  "webhook_secret": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
X-CEKURA-API-KEY
string
header
required

API Key Authentication. It should be included in the header of each request.

Body

​
name
string
required

Agent name.

Maximum string length: 255
​
description
string
required

A detailed description of what this agent does and how it should interact Example:

AI agent for handling customer support inquiries and resolving technical issues
​
project
integer

The project this agent belongs to

​
language
enum<string>
default:en

The primary language this agent uses for communication (e.g. 'en' for English)

  • af - Afrikaans
  • ar - Arabic
  • bn - Bengali
  • bg - Bulgarian
  • zh - Chinese Simplified
  • cs - Czech
  • da - Danish
  • nl - Dutch
  • en - English
  • et - Estonian
  • fi - Finnish
  • fr - French
  • de - German
  • el - Greek
  • gu - Gujarati
  • hi - Hindi
  • he - Hebrew
  • hu - Hungarian
  • id - Indonesian
  • it - Italian
  • ja - Japanese
  • kn - Kannada
  • ko - Korean
  • ms - Malay
  • ml - Malayalam
  • mr - Marathi
  • multi - Multilingual
  • no - Norwegian
  • pl - Polish
  • pa - Punjabi
  • pt - Portuguese
  • ro - Romanian
  • ru - Russian
  • sk - Slovak
  • es - Spanish
  • sv - Swedish
  • th - Thai
  • tr - Turkish
  • tl - Tagalog
  • ta - Tamil
  • te - Telugu
  • uk - Ukrainian
  • vi - Vietnamese
Available options:
af,
ar,
bn,
bg,
zh,
cs,
da,
nl,
en,
et,
fi,
fr,
de,
el,
gu,
hi,
he,
hu,
id,
it,
ja,
kn,
ko,
ms,
ml,
mr,
multi,
no,
pl,
pa,
pt,
ro,
ru,
sk,
es,
sv,
th,
tr,
tl,
ta,
te,
uk,
vi
​
telephony
object

Phone and SIP channel configuration.

​
provider
object

AI platform integration. Nested credentials replace the flat {provider}_api_key fields.

​
agent_speaks_first
boolean | null

True = agent speaks first; False = test user speaks first; null = auto-detect.

​
predefined_metrics
any
write-only

predefined metrics to use for the agent

​
webhook_url
string<uri>

Webhook URL for this agent. When set, overrides the project-level webhook URL for events from this agent.

​
webhook_secret
string

Secret sent in X-CEKURA-SECRET header. Applies when agent webhook_url is set.

Response

​
name
string
required

Agent name.

Maximum string length: 255
​
description
string
required

A detailed description of what this agent does and how it should interact Example:

AI agent for handling customer support inquiries and resolving technical issues
​
id
integer
read-only

Agent ID. Example: 2142

​
project
integer

The project this agent belongs to

​
language
enum<string>
default:en

The primary language this agent uses for communication (e.g. 'en' for English)

  • af - Afrikaans
  • ar - Arabic
  • bn - Bengali
  • bg - Bulgarian
  • zh - Chinese Simplified
  • cs - Czech
  • da - Danish
  • nl - Dutch
  • en - English
  • et - Estonian
  • fi - Finnish
  • fr - French
  • de - German
  • el - Greek
  • gu - Gujarati
  • hi - Hindi
  • he - Hebrew
  • hu - Hungarian
  • id - Indonesian
  • it - Italian
  • ja - Japanese
  • kn - Kannada
  • ko - Korean
  • ms - Malay
  • ml - Malayalam
  • mr - Marathi
  • multi - Multilingual
  • no - Norwegian
  • pl - Polish
  • pa - Punjabi
  • pt - Portuguese
  • ro - Romanian
  • ru - Russian
  • sk - Slovak
  • es - Spanish
  • sv - Swedish
  • th - Thai
  • tr - Turkish
  • tl - Tagalog
  • ta - Tamil
  • te - Telugu
  • uk - Ukrainian
  • vi - Vietnamese
Available options:
af,
ar,
bn,
bg,
zh,
cs,
da,
nl,
en,
et,
fi,
fr,
de,
el,
gu,
hi,
he,
hu,
id,
it,
ja,
kn,
ko,
ms,
ml,
mr,
multi,
no,
pl,
pa,
pt,
ro,
ru,
sk,
es,
sv,
th,
tr,
tl,
ta,
te,
uk,
vi
​
telephony
object

Phone and SIP channel configuration.

​
provider
object

AI platform integration. Nested credentials replace the flat {provider}_api_key fields.

​
agent_speaks_first
boolean | null

True = agent speaks first; False = test user speaks first; null = auto-detect.

​
knowledge_base_files
string
read-only

List of knowledge base files attached to the agent Example: [1, 2, 3]

​
enabled_personalities
integer[]
read-only

Personality profiles enabled for this agent Example: [1, 2, 3]

​
webhook_url
string<uri>

Webhook URL for this agent. When set, overrides the project-level webhook URL for events from this agent.

​
webhook_secret
string

Secret sent in X-CEKURA-SECRET header. Applies when agent webhook_url is set.

​
created_at
string<date-time>
read-only

Timestamp when the agent was created Example: "2021-01-01T00:00:00Z"

​
updated_at
string<date-time>
read-only

Timestamp when the agent was last updated Example: "2021-01-01T00:00:00Z"