Fetch a call's transcript
The turn-by-turn transcript, once the call has ended. A call with no audio — a sandbox call, an unanswered one — has no transcript.
Requires the read scope. A key with less gets 403 insufficient_scope.
Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.
In: header
Path Parameters
The call's id.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/calls/string/transcript"{ "data": null}Hand a live call to a person
Asks the agent on the call to transfer it to one of the destinations it may use, exactly as if it had decided to itself: the caller hears the transfer line, the person hears the brief, and every rule still applies — the destination must be verified, inside its hours and one of the agent's destinations, and a call makes at most two attempts. A transfer that cannot start is accepted: false with a refusal, not an error. 409 call_not_live when no agent is on the call. Send an Idempotency-Key to make a retry safe.
Fetch the recording of the part with a person
After the agent handed the call to a person: the recording of that part of the call, as audio/wav (stereo, the caller on the left channel and the person on the right) or audio/mpeg (the carrier's own two-channel recording). Not enveloped. Absent when the agent's transfer setting has recording off, or when nobody took the call.