Skip to main content
POST
Create Voice Clip Set

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 creating a voice clip set.

Creation only writes the row and enqueues extraction — the clips themselves are produced asynchronously by the voice-clip-extractor Lambda, which is why this schema carries no clip data.

name
string
required
Required string length: 1 - 255
source_call_id
integer
required
description
string | null
Maximum string length: 10000
extraction_settings
Extraction Settings · object | null

Optional overrides for merge_gap_ms/min_turn_ms/pad_ms, consumed by the extractor. Omit to use its defaults.

Response

Successful Response

Response schema for a single voice clip set (without its clips).

id
integer
required
name
string
required
status
string
required
clip_count
integer
required
created_at
string<date-time>
required
description
string | null
total_duration_ms
integer | null
caller_track_duration_ms
integer | null
source_call_id
integer | null
source_channel_mode
string | null
failure_reason
string | null