Skip to main content
POST
Create an ambient audio upload URL
Requires Editor, Admin, or Owner. Send the numeric workflow_id, filename, MIME type, and file size (maximum 10,485,760 bytes). The response includes an upload URL valid for 30 minutes, storage_key, and storage_backend. Upload the file bytes with PUT to the signed URL using the declared content type. Do not send your Agent Builder credential to the upload host. Uploading alone does not activate the audio. A missing agent returns 404. Retrieve the current agent, preserve its other settings, and use Update agent to set workflow_configurations.ambient_noise_configuration. The following fragment shows the fields to merge; replace the key and backend with the upload response values.
Keep unrelated agent configuration intact, test the draft, and publish when ready. original_filename is optional.

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
file_size
integer
required
Required range: x <= 10485760
filename
string
required
workflow_id
integer
required
mime_type
string
default:audio/wav

Response

Successful Response

storage_backend
string
required
storage_key
string
required
upload_url
string
required