Skip to main content
POST
Register uploaded recordings
Requires Editor, Admin, or Owner. Submit 1–20 recordings using the exact recording_id and storage_key supplied by the upload operation. Each recording requires a transcript; optional TTS metadata identifies the voice used. Upload the bytes before registration. A storage key outside the workspace upload location returns 403. The response contains the created recordings.

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.

Body

application/json
recordings
RecordingCreateRequestSchema · object[]
required
Required array length: 1 - 20 elements

Response

Successful Response

recordings
RecordingResponseSchema · object[]
required