Skip to navigation

Download a call recording

Streams the call’s selected verified immutable recording through the authenticated API as an attachment. The response never exposes a storage URI or signed URL and never converts or rewrites audio. With no Range header it returns the whole object. One satisfiable byte range returns 206; an unsatisfiable range returns 416 with no body; malformed or multiple ranges return 400. A malformed or foreign call id, a call without servable recording evidence, and stored metadata that contradicts the index all return the same hidden 404.

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.

Headers

RangestringOptional<=128 characters

Optional single RFC 9110 byte range, for example bytes=0-1048575.

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.
Accept-RangesenumOptional
The endpoint accepts one byte range.
Allowed values:
Content-LengthintegerOptional

Exact response-body byte count.

Content-DispositionstringOptional
Sanitised attachment filename derived from the call id and verified media type.
ETagstringOptional

Quoted SHA-256 of the verified recording.

Cache-ControlstringOptional

Private no-store caching policy.

X-Content-Type-OptionsenumOptional
Prevents content sniffing.
Allowed values:

Response

The whole verified recording.

Errors

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