Take over conversation | Speechify API

Take over an active voice-agent call. Returns short-lived credentials a real-time client uses to connect an authorized operator into the live call. The operator speaks to the caller directly while the AI agent stands down and stays silent, then resumes once the operator hands the call back. The requester must be an owner or admin of the workspace the call belongs to. Only an active call can be taken over; a pending or completed call returns 409.

Take over an active voice-agent call. Returns short-lived credentials a real-time client uses to connect an authorized operator into the live call. The operator speaks to the caller directly while the AI agent stands down and stays silent, then resumes once the operator hands the call back. The requester must be an `owner` or `admin` of the workspace the call belongs to. Only an active call can be taken over; a pending or completed call returns 409.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

idstringRequired

Response

Take-over connection details.

conversation_idstring

room_namestring

livekit_urlstring

Signaling URL the real-time client connects to.

tokenstring

Short-lived access token authorizing the operator to publish audio to and subscribe to the live call.

identitystring

Opaque participant identity for the operator's session.

expires_atdatetime

When the token stops being accepted. The client should re-mint past this point.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

$	curl -X POST https://api.speechify.ai/v1/agents/conversations/id/takeover \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"conversation_id": "conv_8f3b2a7d9c4e5f1a",
3	"room_name": "acme_inc_support_room_42",
4	"livekit_url": "wss://livekit.speechify.ai",
5	"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJvcGVyYXRvcl9jbGlmZndlaXR6bWFuIiwicm9vbV9pZCI6ImFjbWVfaW5jX3N1cHBvcnRfcm9vbV80MiIsImlhdCI6MTY4NjQ3MjAwMCwiZXhwIjoxNjg2NDc1NjAwfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
6	"identity": "operator_cliff_weitzman",
7	"expires_at": "2024-01-15T09:30:00Z"
8	}