Skip to main content
POST
Start a voice session

Authorizations

Authorization
string
header
required

API key from your account settings

Path Parameters

agentId
string
required

The agent ID

Minimum string length: 1
Example:

"5QHA6VB-DIAbBhxwqxfdi"

Body

application/json
conversationId
string<uuid>

Optional conversation UUID. Reuse a value to group multiple voice sessions into one conversation in chat logs. If omitted, a new conversation is created.

userId
string

Your end-user ID. Send a stable ID so per-user voice limits apply; if omitted a random one is generated per session. Must contain only URL-safe characters (letters, digits, hyphens, underscores, dots).

Maximum string length: 128
Pattern: ^[a-zA-Z0-9._-]+$
timezone
string
default:UTC

IANA timezone of the end user (e.g. "Europe/Paris"), used by the agent for time-aware answers. Defaults to UTC.

Maximum string length: 64

Response

Voice session created

data
object
required