Upload Audio Asset
Upload a new audio asset. The body is a multipart/form-data
request with a single `file` field carrying the WAV bytes.
The WAV is validated server-side against a strict format
contract — PCM 16-bit signed, mono, 48000 Hz, ≤30s, ≤4 MiB —
before any bytes hit storage. The strict shape matches the
LiveKit room sample rate so the worker reads bytes straight
into `rtc.AudioFrame` with no decode dependency on either side;
convert MP3 sources with `ffmpeg -i in.mp3 -ar 48000 -ac 1
-sample_fmt s16 out.wav`.
Authentication
AuthorizationBearer
Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.
Request
This endpoint expects a multipart form containing a file.
file
The WAV file bytes. Must be PCM 16-bit signed, mono, 48000 Hz, ≤30s duration, ≤4 MiB total.
Response
The uploaded asset's metadata.
asset
Metadata for a pre-recorded WAV clip stored in the workspace’s audio-asset bucket. Bytes are immutable once uploaded — to replace a clip, upload a new asset and update any references.
Errors
400
Bad Request Error
401
Unauthorized Error