Stream recording media (target of a `proxied` URL)
curl --request GET \
--url https://{host}/api/projects/{projectId}/recordings/{recordingId}/media/content/{mediaToken}"<string>""<string>"{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "INVALID_RECORDING_MEDIA_TOKEN",
"message": "Invalid media token"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "RECORDING_NOT_READY",
"message": "Recording media is not ready"
}
}Stream a recording
Stream a call recording file from a proxied media URL, with HTTP range support.
GET
/
api
/
projects
/
{projectId}
/
recordings
/
{recordingId}
/
media
/
content
/
{mediaToken}
Stream recording media (target of a `proxied` URL)
curl --request GET \
--url https://{host}/api/projects/{projectId}/recordings/{recordingId}/media/content/{mediaToken}"<string>""<string>"{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "INVALID_RECORDING_MEDIA_TOKEN",
"message": "Invalid media token"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"success": false,
"error": {
"code": "RECORDING_NOT_READY",
"message": "Recording media is not ready"
}
}abl_...) with the recordings.read scope. Send the key in either the x-api-key header or the Authorization: Bearer header. Studio user JWTs, JWT App assertions, and public pk_ keys are not accepted.
Stream recording media
Use this endpoint to stream a recording when the session recordings endpoint returns a file withurlKind: proxied. Prefix the returned relative URL with the API host and send a GET request to the complete URL. Don’t construct the URL on your own.
The mediaToken embedded in the URL is the credential for this request. Do not send an x-api-key or Authorization header. The token is short-lived and bound to the tenant, project, recording, file index, disposition, and issuing API key.
This endpoint supports HTTP range requests for seeking or retrieving part of a file. Send a Range header, such as Range: bytes=0-65535, to request a byte range.
Response behavior
200 OK: Returns the full media file.206 Partial Content: Returns the requested byte range.302 Found: The file is hosted at an external URL; follow the redirect.
Errors
400: Invalid file index or media disposition.401: The media token is invalid, expired, or does not match the request.404: The recording or requested file is not found, or the stored media object is missing.409: The recording is not yet complete (RECORDING_NOT_READY).416: The requested byte range cannot be satisfied.504: Streaming did not finish within five minutes.
Path Parameters
Query Parameters
Response
The full media file.
The response is of type file.
Was this page helpful?