Skip to main content
POST
Complete Voice Clip Upload

Authorizations

Authorization
string
header
required

Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.

Path Parameters

voice_clip_upload_id
integer
required

ID of the voice clip upload

agent_id
integer
required

Tuner's internal numeric ID for the agent.

workspace_id
integer
required

Workspace ID. Find this in Workspace > General Settings.

Body

application/json

The parts to assemble into the finished upload.

parts
CompletedPart · object[]
required

Every uploaded part, each with its part number and ETag.

Response

Successful Response

Status of an uploaded recording.

id
integer
required

Voice clip upload ID.

status
string
required

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.

filename
string
required

Original file name of the recording.

extension
string
required

File extension of the recording.

size_bytes
integer
required

Declared size of the recording, in bytes.

created_at
string<date-time>
required

When the upload was started.

duration_ms
integer | null

Duration of the recording in milliseconds. Set after analysis.

channel_count
integer | null

Number of audio channels. Set after analysis.

channel_mode
string | null

mono or multi_channel. Set after analysis.

speakers
VoiceClipUploadSpeaker · object[] | null

Channels detected in the recording. Set after analysis.

failure_reason
string | null

Why the upload failed. Set only when status is failed.