Skip to main content
GET
List audio recordings
Optionally filter by agent (workflow_id), TTS provider, model, or voice. The response includes recordings and total. A recording has both a numeric row id and a string recording_id; operations below distinguish them.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Query Parameters

workflow_id
integer | null

Filter by workflow ID

tts_provider
string | null

Filter by TTS provider

tts_model
string | null

Filter by TTS model

tts_voice_id
string | null

Filter by TTS voice ID

Response

Successful Response

recordings
RecordingResponseSchema · object[]
required
total
integer
required