Skip to main content
POST
Start 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

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

Input schema for starting a resumable upload.

size_bytes is the client's declared size. It is what the part plan is computed from and what the size gate rejects on; S3 is still the authority on what actually landed.

filename
string
required
Required string length: 1 - 512
extension
string
required
Required string length: 1 - 10
size_bytes
integer
required
Required range: x <= 209715200

Response

Successful Response

The create response: the upload plus everything needed to start pushing bytes.

id
integer
required
status
string
required
filename
string
required
extension
string
required
size_bytes
integer
required
created_at
string<date-time>
required
part_size_bytes
integer
required
expires_at
string<date-time>
required
duration_ms
integer | null
channel_count
integer | null
channel_mode
string | null
speakers
VoiceClipUploadSpeaker · object[] | null
failure_reason
string | null
parts
VoiceClipUploadPart · object[]