Start Voice Clip Upload
Start a resumable audio upload.
Returns a presigned upload URL for every part up front. Use Get Voice Clip Upload Parts to resume an interrupted upload or to get fresh URLs after they expire.
Authorizations
Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.
Path Parameters
Tuner's internal numeric ID for the agent.
Workspace ID. Find this in Workspace > General Settings.
Body
Details of the recording to upload.
Original file name of the audio recording, up to 512 characters.
1 - 512File extension of the recording, with or without a leading dot. One of flac, m4a, mp3, ogg, wav, webm.
1 - 10Size of the recording in bytes, up to 200 MB. The upload is split into parts based on this size.
x <= 209715200Response
Successful Response
A new upload, with the URLs to send its parts to.
Voice clip upload ID.
Upload status: uploading, uploaded, analyzing, awaiting_selection, consumed or failed. awaiting_selection means the recording is ready for you to pick the caller's channel; consumed means a clip set has been built from it.
Original file name of the recording.
File extension of the recording.
Declared size of the recording, in bytes.
When the upload was started.
Size of each part in bytes. Every part except the last must be this size.
When the part URLs expire.
Duration of the recording in milliseconds. Set after analysis.
Number of audio channels. Set after analysis.
mono or multi_channel. Set after analysis.
Channels detected in the recording. Set after analysis.
Why the upload failed. Set only when status is failed.
One presigned upload URL per part.