AgentAudio Assets

Get Audio Asset

Fetch one audio asset’s metadata. Returns 404 for missing, soft-deleted, or foreign-tenant assets — existence information is never leaked across tenants.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

idstringRequired

Response

The audio asset's metadata.
idstring

Prefixed wire identifier (audio_<26 char Crockford base32>). URL paths accept only this prefixed form; legacy UUID path parameters are rejected with 404.

original_filenamestring
The filename supplied at upload time, kept for display.
content_typestring

Always audio/wav. Pinned server-side after WAV validation rather than trusting the upload’s multipart Content-Type header.

size_bytesinteger
Stored byte length. Capped at 4 MiB at upload time.
duration_msinteger

Clip duration in milliseconds. Capped at 30000 (30s) at upload time.

sample_rate_hzinteger

WAV sample rate. Always 48000 (matches the LiveKit room rate).

channelsinteger

Channel count. Always 1 (mono).

bit_depthinteger
PCM sample bit depth. Always 16.
created_atdatetime

Errors

401
Unauthorized Error
404
Not Found Error