Made in 10Docs
GuidesAPI
ReferenceCalls

Start a call

Starts a live call with a character and answers where to connect.

POST
/calls

Authorization

secretKey
headerAuthorizationBearer <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.

Header Parameters

Idempotency-Key?string

Any 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.

Length1 <= length <= 200

Request Body

application/json
  1. body
Example
{  "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",  "max_seconds": 300,  "metadata": {    "ticket": 7  },  "memory_key": "user_42"}
character_id*CharacterId

A character's id.

Match^chr_[0-9A-Za-z]{20}$
Example"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.

Range1 <= value
metadata?|

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.

Lengthlength <= 4000
Example"Candidate Sara Ahmadi"
Example"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.

Example
{  "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.

Example"de"
caller_name?|

The person's first name, for the greeting and {{caller_name}}.

Lengthlength <= 60
Example"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.

Example"voice"
Value in"voice""video"null

Response Body

The call has started. Connect within 120 seconds.

application/json
  1. response

Where to connect to a call that has started.

Example
{  "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*CallId

A call's id (ours; the engine's session id is never shown).

Match^call_[0-9A-Za-z]{20}$
Example"call_2Gx7Mb9KpQ4sVn1ZrT6e"
status*string

waiting for a new call. A replay (the same Idempotency-Key) gives the call's status now.

Value in"waiting""ended""failed"
character_id*CharacterId

A character's id.

Match^chr_[0-9A-Za-z]{20}$
Example"chr_4fT9kQ2mXw7LbN3pZs8V"
max_seconds*integer

The longest this call will run (see max_seconds in the request).

ws_url*string

The 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.

Example"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.

Example"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*Unix

Unix seconds, UTC.

Formatint64
Example1793300000
mode?|

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.

Value in"voice""video"null
Example Request
curl -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"}'
Example Response
{  "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}