Skip to main content
PATCH
cURL

Continue building

Manage Studio projects

Import scripts, edit safely, and retry writes.

Update clips in bulk

Change up to 100 clips in one write.

Studio CLI

Run the same operations from a terminal.

Authorizations

xi-api-key
string
header
required

Breeze Developer API key.

Path Parameters

project_id
string
required

Studio project ID, such as prj_….

clip_id
string
required

Clip ID, such as clp_….

Body

application/json
expected_edit_token
string
required

edit_token from your latest read or write of this project. A stale token returns 409.

Required string length: 1 - 128
operation_id
string<uuid>
required

New UUID for each write. Retrying with the same ID and body returns the original result instead of repeating the write.

name
string | null

Clip label shown in the editor.

Maximum string length: 120
script
string | null

Text to speak. Line breaks inside the text become spaces.

Maximum string length: 1000
instructions
string | null

Delivery instructions for this clip. Empty uses the project's default_instructions. See Expressive controls, Voice instruction prompting.

Maximum string length: 1000
voice_id
string | null

Voice for this clip. See List voices.

Required string length: 1 - 128
Pattern: \S
playback
Playback · object | null

Playback speed and volume.

trailing_silence_ms
integer | null

Silence after the clip in milliseconds. null uses the project's default_silence_ms; 0 means no pause.

Required range: 0 <= x <= 600000

Response

The updated project.

project
ProjectView · object
required

The project after this request.

edit_token
string
required

Current edit_token. Send it as expected_edit_token on the next write.

client_refs
Client Refs · object

Import only: each client_ref mapped to its created ID.

created_ids
string[]

IDs created by this request, in order.