Start a call
Starts a live call with a character and answers where to connect.
secretKeyAuthorizationBearer <sk_live_… or sk_test_… (a prefix and 40 base62 characters)>A secret key from the dashboard, sent as Authorization: Bearer sk_live_…. Live keys run real, charged calls; test keys (sk_test_…) run calls of at most 60 seconds, 20 a day per organization, never charged. Each key sees only its own env's calls, meetings, webhooks, memories and analytics. Publishable keys (pk_…) are refused.
Idempotency-Key?stringAny string of 1 to 200 bytes (surrounding spaces are trimmed), unique per call you mean to start, such as a UUID. The same key gives back the same call. While the first request with it is still starting: 409 idempotency_in_progress; if it failed: 409 idempotency_failed (send a new key); used for another character: 422 idempotency_mismatch. Only the character is compared: a different max_seconds or metadata with the same key still gives back the first call. Keys are kept with the call, per organization and env: a test key and a live key sending the same value each get their own call (or meeting), never the other's. Use plain ASCII: a value that isn't is ignored, as if no key were sent.
1 <= length <= 200application/json- body
{ "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V", "max_seconds": 300, "metadata": { "ticket": 7 }, "memory_key": "user_42"}character_id*CharacterIdA character's id.
^chr_[0-9A-Za-z]{20}$"chr_4fT9kQ2mXw7LbN3pZs8V"max_seconds?|The longest you want this call to run. It may come back lower (the character's limit, 60 s for a test key, what the balance covers). Under 30 on a paid organization is 402.
1 <= valuemetadata?|Any JSON object of at most 4 KB (as compact JSON). It is returned on the call, in its webhooks and in each tool call. Null or left out is {}.
memory_key?|Who the call is with, for memories. Left out, nothing is remembered.
context?|Plain text the character should know about this call (the candidate, the order, the account). It reaches the prompt before the greeting; the person never sees it.
length <= 4000"Candidate Sara Ahmadi""applying for data engineer. Five years of Spark."variables?|Values for {{name}} in the character's instructions and greeting. Names are letters, digits and _ (not starting with a digit), up to 40; at most 30, each value up to 500 characters, 4,000 together. A number or true/false is taken as its text. An unknown {{name}} becomes nothing (a space before punctuation goes with it). {{caller_name}} is built in.
{ "role": "data engineer", "first_name": "Sara"}language?|The call's language, a code from the catalog. Left out or auto is the character's own.
"de"caller_name?|The person's first name, for the greeting and {{caller_name}}.
length <= 60"Sara"mode?|voice: the call runs without the character's face, even when it has one (ws.face is null), in the voice it has on video. video: with its face; a character without one is 400 mode_not_allowed. Left out, the character's face decides. A deployment's call_modes limit only its website widget, never a secret key. A voice call is priced as a video one for now.
"voice""voice""video"nullThe call has started. Connect within 120 seconds.
application/json- response
Where to connect to a call that has started.
{ "id": "call_2Gx7Mb9KpQ4sVn1ZrT6e", "status": "waiting", "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V", "max_seconds": 300, "mode": "video", "ws_url": "wss://talk.madein10.com/live/a1b2c3d4?token=1793300300.k3Jx9Q…", "events_url": "wss://talk.madein10.com/live-events/a1b2c3d4?token=ev.1793300420.k3Jx9Q…", "ws": { "path": "/live/a1b2c3d4", "token": "1793300300.k3Jx9Q…", "input_rate": 16000, "output_rate": 24000, "face": { "vendor": "livekit", "provider": "acme", "livekit_url": "wss://rooms.example.com", "room": "acme-a1b2c3d4", "token": "eyJhbGciOiJIUzI1NiJ9…", "identity": "acme-a1b2c3d4-browser", "avatar_identity": "acme-face", "sample_rate": 24000, "feed": { "kind": "data_stream" } }, "events": { "path": "/live-events/a1b2c3d4", "token": "ev.1793300420.k3Jx9Q…" } }, "created_unix": 1793300000}id*CallIdA call's id (ours; the engine's session id is never shown).
^call_[0-9A-Za-z]{20}$"call_2Gx7Mb9KpQ4sVn1ZrT6e"status*stringwaiting for a new call. A replay (the same Idempotency-Key) gives the call's status now.
"waiting""ended""failed"character_id*CharacterIdA character's id.
^chr_[0-9A-Za-z]{20}$"chr_4fT9kQ2mXw7LbN3pZs8V"max_seconds*integerThe longest this call will run (see max_seconds in the request).
ws_url*stringThe call's sound, for the person's browser or app: wss://<host>/live/<session>?token=…. Connect within 120 seconds. The token works once and for 5 minutes.
"wss://talk.madein10.com/live/a1b2c3d4?token=1793300300.k3Jx9Q…"events_url*|The call's live events and control, for your server only (never hand it to a browser): wss://<host>/live-events/<session>?token=ev.…. Reusable by up to 5 listeners at once, for as long as the call can run plus 5 minutes. Null only with an older engine.
"wss://talk.madein10.com/live-events/a1b2c3d4?token=ev.1793300420.k3Jx9Q…"ws*The engine's ticket for the call's sound, as it gave it. ws_url is path and token on our public host; use the rates to record and play. A token works once and for 5 minutes. With a face, face says where it plays and how to feed it our voice.
created_unix*UnixUnix seconds, UTC.
int641793300000mode?|What the call runs in: video with the character's face, voice without one (ws.face is then null). Null only on a replay of a call made before 2026-11-12.
"voice""video"nullcurl -X POST 'https://api.daxov.com/v1/calls' \ -H 'Idempotency-Key: 5f0c7a52-3d1e-4b8a-9f61-2c4d8e7b9a10' \ -H 'Content-Type: application/json' \ -d '{ "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V", "max_seconds": 300, "metadata": { "ticket": 7 }, "memory_key": "user_42"}'{ "id": "call_2Gx7Mb9KpQ4sVn1ZrT6e", "status": "waiting", "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V", "max_seconds": 300, "mode": "video", "ws_url": "wss://talk.madein10.com/live/a1b2c3d4?token=1793300300.k3Jx9Q…", "events_url": "wss://talk.madein10.com/live-events/a1b2c3d4?token=ev.1793300420.k3Jx9Q…", "ws": { "path": "/live/a1b2c3d4", "token": "1793300300.k3Jx9Q…", "input_rate": 16000, "output_rate": 24000, "face": { "vendor": "livekit", "provider": "acme", "livekit_url": "wss://rooms.example.com", "room": "acme-a1b2c3d4", "token": "eyJhbGciOiJIUzI1NiJ9…", "identity": "acme-a1b2c3d4-browser", "avatar_identity": "acme-face", "sample_rate": 24000, "feed": { "kind": "data_stream" } }, "events": { "path": "/live-events/a1b2c3d4", "token": "ev.1793300420.k3Jx9Q…" } }, "created_unix": 1793300000}