Recordings

Get recording playback URLs

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/recordings/{call_sid}/urls

Generate presigned S3 URLs for streaming call recording playback. Returns separate URLs for inbound (caller) and outbound (agent) audio channels, plus the recording metadata file. URLs expire after 1 hour. For archived recordings (>3 days old, GLACIER_IR), returns 202 Accepted with estimated restore time.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

call_sidstringRequired

Responses

200

Successful Response

application/json

Presigned URLs for call recording playback.

call_sidstringRequired

statusstring · enumOptionalDefault: availablePossible values:

inbound_urlany ofOptional

stringOptional

or

nullOptional

outbound_urlany ofOptional

stringOptional

or

nullOptional

metadata_urlany ofOptional

stringOptional

or

nullOptional

expires_inintegerOptionalDefault: 3600

restore_estimate_hoursany ofOptional

numberOptional

or

nullOptional

202

Recording is archived — restore initiated

404

Recording not found

422

Validation Error

application/json

503

Call recording not configured

get

/v1/{workspace_id}/recordings/{call_sid}/urls

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/recordings/{call_sid}/urls HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "call_sid": "text",
  "status": "available",
  "inbound_url": "text",
  "outbound_url": "text",
  "metadata_url": "text",
  "expires_in": 3600,
  "restore_estimate_hours": 1
}

Get recording metadata

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/recordings/{call_sid}/metadata

Fetch metadata for a call recording including duration, audio formats, sample rates, and file sizes.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

call_sidstringRequired

Responses

200

Successful Response

application/json

Call recording metadata from S3.

call_sidstringRequired

workspace_idstringRequired

service_idstringRequired

directionstringRequired

duration_secondsnumberRequired

inbound_formatstringRequired

inbound_sample_rateintegerRequired

outbound_formatstringRequired

outbound_sample_rateintegerRequired

tts_providerstringRequired

call_start_isostringRequired

call_end_isostringRequired

inbound_size_bytesintegerRequired

outbound_size_bytesintegerRequired

media_start_epoch_msnumberRequired

404

Recording not found

422

Validation Error

application/json

503

Call recording not configured

get

/v1/{workspace_id}/recordings/{call_sid}/metadata

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/recordings/{call_sid}/metadata HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "call_sid": "text",
  "workspace_id": "text",
  "service_id": "text",
  "direction": "text",
  "duration_seconds": 1,
  "inbound_format": "text",
  "inbound_sample_rate": 1,
  "outbound_format": "text",
  "outbound_sample_rate": 1,
  "tts_provider": "text",
  "call_start_iso": "text",
  "call_end_iso": "text",
  "inbound_size_bytes": 1,
  "outbound_size_bytes": 1,
  "media_start_epoch_ms": 1
}