Download an Omni call recording

curl --request GET \
  --url https://api.pyai.com/v1/omni/calls/{call_id}/recording \
  --header 'Authorization: Bearer <token>'

{
  "object": "omni.call.recording",
  "call_id": "<string>",
  "url": "<string>",
  "expires_at": 123,
  "expires_in": 123
}

Omni Calls

Download an Omni call recording

Fetch the call’s audio recording, when one exists (recording is off by default). Requires omni:read.

By default this 302-redirects to a short-lived signed URL for the audio (served directly from object storage — droppable into a browser <audio src>, and any HTTP client that follows redirects gets the bytes). Pass ?response=url to receive the signed URL as JSON instead (handy for SDKs that embed it). On deployments without URL signing configured, the endpoint streams the audio bytes back inline (Content-Type reflects the stored format, e.g. audio/wav).

404 if there is no recording for the call.

GET

omni

calls

{call_id}

recording

Download an Omni call recording

curl --request GET \
  --url https://api.pyai.com/v1/omni/calls/{call_id}/recording \
  --header 'Authorization: Bearer <token>'

{
  "object": "omni.call.recording",
  "call_id": "<string>",
  "url": "<string>",
  "expires_at": 123,
  "expires_in": 123
}

Authorizations

Authorization

string

header

required

Use Authorization: Bearer pyai_live_... (or pyai_test_...).

Path Parameters

call_id

string

required

Query Parameters

response

enum<string>

Set to url to return the signed URL as JSON instead of a 302 redirect.

Available options:

url

Response

The signed URL as JSON (?response=url), or the audio bytes streamed inline when signing is not configured.

object

string

Example:

"omni.call.recording"

call_id

string

url

string

Short-lived signed URL to the recording audio.

expires_at

integer

Unix-ms expiry of the signed URL.

expires_in

integer

Seconds until the URL expires.

Get an Omni call record Get an Omni call summary

⌘I