v1

latestOpenAPI 3.0.12026-07-2649123153.6 KB

/api/v1/ambient/session

Get ambient session recording URLs

Returns presigned URLs to stream or download session recordings. URLs are temporary; use them before they expire.

get/api/v1/ambient/session/{ambient_session_id}/recording

Path parameters

ambient_session_idstring required

UUID for the ambient session. Use the ambient_session_id returned from Create Ambient Session, or the UUID you supplied in that request.

Query parameters

downloadboolean

If true, returns download-only URLs; if false or omitted, URLs support streaming with Range requests.

Headers

sdp_provider_idstring

Example:provider-123

Optional for standard partners.

Required for:

Bearer authentication. Use the same provider_id returned by the Login or Register API.
Single Auth Token authentication. Include the same provider_id on every request as sdp_provider_id.

Response

Request succeeded.

is_streamableboolean

Whether the returned URLs support streaming with Range requests.

Example response

{
  "recordings": [
    {
      "recording_id": "01KFJZTJWZH28GRHQXVCGW4Y47",
      "presigned_url": "https://storage.googleapis.com/...",
      "expires_at": 1738765432,
      "sequence_number": 1
    }
  ],
  "is_streamable": true
}