Skip to main content
GET
Get 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.

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.