Create a new agent
Create a new voice AI agent
API key in the format: Bearer YOUR_API_KEY
In: header
1 <= length <= 255length <= 32000uuiduuid10.6 <= value <= 1.5Voice stability setting (ElevenLabs/Faseeh only)
0.50 <= value <= 1Silence duration in ms before the agent responds (default: 100)
50 <= value <= 2000Minimum speech duration in ms to count as a valid turn (default: 50)
0 <= value <= 2000How long in ms the user must speak to interrupt the agent (default: 100)
0 <= value <= 2000VAD probability threshold for speech detection (default: 0.35)
0 <= value <= 1Echo guard timeout in ms after agent stops speaking (default: 400)
0 <= value <= 5000End-of-turn probability threshold (default: 0.1)
0 <= value <= 1How quickly in ms to start speculative inference on silence (default: 150)
0 <= value <= 5000Fallback timeout in ms if endpointing fails (default: 3000)
0 <= value <= 10000truetruefalse[]uri"user""user" | "agent"length <= 1000falseWhether the agent's first message cannot be interrupted by the user (only applies when firstSpeaker is 'agent')
falseMilliseconds to wait before the agent sends its first message (only applies when firstSpeaker is 'agent')
00 <= value <= 1000060030 <= value <= 3600ISO 639-1 language code hint for transcription (e.g., 'ar', 'en')
length <= 10Custom instructions for when the agent should search its knowledge base
length <= 2000ID of the background sound to play during calls
uuidVolume of the background sound (0.0 to 1.0)
0.150 <= value <= 1Message the agent speaks to the caller when placing them on hold during a warm transfer
length <= 500URL of hold music audio to play while the caller is on hold during a warm transfer
length <= 500Response Body
application/json
application/json
application/json
curl -X POST "https://api.chorus-ai.co/v1/agents" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{
"data": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"systemPrompt": "string",
"slmModelId": "063c8b9b-716c-4479-8636-e6af423a21d0",
"voiceId": "a03665cd-ad55-4641-90b0-a6149c64fe33",
"voiceSpeed": 1,
"voiceStability": 0.5,
"turnEndpointDelay": 50,
"minTurnDuration": 2000,
"minInterruptionDuration": 2000,
"frameActivationThreshold": 1,
"postSpeechCooldown": 5000,
"ultravadEotThreshold": 1,
"speculativeSilenceMs": 5000,
"fallbackSilenceMs": 10000,
"isActive": true,
"allowEndCall": true,
"postCallSummaryEnabled": false,
"postCallExtractionSchema": [],
"postCallWebhookUrl": "http://example.com",
"postCallWebhookSecret": "string",
"firstSpeaker": "user",
"agentGreeting": "string",
"agentGreetingEnabled": true,
"firstMessageUninterruptible": false,
"firstMessageDelay": 0,
"maxCallDurationSeconds": 600,
"languageHint": "string",
"knowledgeSearchInstructions": "string",
"backgroundSoundId": "2d4fd124-f5e0-412f-938f-f63bafc5b5c7",
"backgroundSoundVolume": 0.15,
"holdMessage": "string",
"holdMusicUrl": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
}{
"error": "string",
"details": [
{}
]
}{
"error": "string",
"details": [
{}
]
}Last updated on