AgentAdmin

Mint shadow-call token

Mint a listen-only LiveKit access token so an authorized observer can join an ongoing voice-agent conversation as a hidden participant. Caller must be an `owner` or `admin` of the workspace the conversation belongs to. The token cannot publish audio or data; the observer is invisible to the caller and the agent. Speechify support engineers reach this endpoint the same way as any other observer — by being granted the owner/admin role on the customer's workspace (typically under an NDA-backed support arrangement).

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired

Response

Shadow-call connection details.

conversation_idstring
room_namestring
livekit_urlstring

wss://… signaling URL for the LiveKit project hosting the room.

tokenstring

Short-lived LiveKit access token. Grant has CanPublish=false, CanPublishData=false, CanSubscribe=true, Hidden=true so the observer can listen but cannot speak and is invisible to the caller and the agent.

identitystring

Opaque participant identity tag (e.g. shadow_<hex>). Visible only to admin tooling.

expires_atdatetime

When the token stops being accepted by LiveKit. The console should re-mint past this point.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error