Skip to navigation

Prewarm browser voice for an agent

Signals intent to start a browser voice call (for example, the pointer entered the microphone button) so the WebSocket connect and first turn find warm state. Authenticated exactly like /agents/{agentId}/speak: send the client token as Authorization: Bearer ct_…; the token agent allowlist and origin allowlist apply. Returns 204 as soon as the caller is authenticated and warms in the background. The call never bills, reserves quota, or meters usage. Warming is rate-limited per client token and agent; a limited call still returns 204 and does nothing.

Path parameters

agentIdstringRequired

The voice-enabled agent the call will open.

Headers

x-visitor-tokenstringOptional
The visitor proof the call will present, sent the same way the voice WebSocket accepts it.

Query parameters

sessionIdstringOptional
The client session the call will resume, when the host already has one.

Response

Accepted. Warming, if admitted, continues in the background.

Errors

401
Unauthorized Error
404
Not Found Error