Skip to navigation
API referenceCalls

Read a transcript page

Read-only selected transcript layer. Use downloadCallRecording for the verified audio. Pending/absent/failed are explicit resource states.

Authentication

AuthorizationBearer

Create and manage workspace-owned keys through the existing app session routes, outside this public API. Creator and manager identities are audit actors only. Key validity follows workspace policy, expiry and explicit revocation, independently of creator membership. Do not include a workspace-selection header.

Path parameters

call_idstringRequired1-128 characters
Resource identity within the authenticated workspace.

Query parameters

limitintegerOptional1-200Defaults to 50

Page size; 50 by default, at most 200.

cursorstringOptional
Opaque cursor bound to the workspace, every filter, grouping and limit. Send them unchanged with it. Expires after 24 hours.

Response headers

X-Request-IdstringOptional
Safe server request correlation ID.
RateLimit-LimitintegerOptional
Requests allowed in the current window for the tightest applicable limit.
RateLimit-RemainingintegerOptional
Requests left in the current window.
RateLimit-ResetintegerOptional
Seconds until the current window resets.

Response

Read a transcript page.
call_idstring<=128 characters
Opaque call identifier. Do not parse its contents.
statestring

Open response vocabulary. Preserve unknown values; never assume they mean success.

result_idstring or null<=128 characters

Stable selected transcript-layer identity.

itemslist of objects
next_cursorstring or null
turn_countinteger or null>=0
poll_after_secondsinteger or null>=1

Hint while pending; null if no more polling is useful.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error