Skip to main content
POST

Overview

Returns a short-lived, ready-to-connect WebSocket URL for the call’s post-transfer transcript stream. Use this from your backend so browser clients never see your long-lived API key; the returned URL carries only a 5-minute credential scoped to this one call. The URL is opaque — connect to it exactly as returned. Do not parse it or construct your own. The URL becomes available when the call is answered (that is when the server handling the call is assigned). Until then this endpoint returns 404 with CALL_NOT_FOUND (“Call was either not found or not started” — the same response as Listen to Active Call); poll every second or two after placing the call. Once connected, you can hold the socket through the rest of the call — it parks until the transfer starts.
The post-transfer transcript stream is in limited rollout. If this endpoint returns 403 with FEATURE_NOT_ENABLED, it is not yet enabled for your organization.

Headers

authorization
string
required
Your API key for authentication.

Path Parameters

call_id
string
required
The call whose post-transfer transcript you want to stream. The call must have been created with include_post_transfer_transcript: true.

Body Parameters

This endpoint takes no body. POST an empty body or {}.

Response

data.url
string
Opaque WebSocket URL. Connect to it as returned, within 5 minutes.
data.expires_in_seconds
number
Lifetime of the URL’s embedded credential. Currently 300 (5 minutes). The TTL gates the connection handshake only; an established stream is not closed when it expires.
errors
null | array
null on success. 401 when the call belongs to a different organization, 403 when the feature is not enabled for your organization, 404 with CALL_NOT_FOUND when the call does not exist or has no active transcript stream (not created with include_post_transfer_transcript, not yet answered, or already ended).

Docs for agents: llms.txt