curl \
--request DELETE \
--url "https://api.breeze.blue/v1/studio/projects/prj_example/chapters/123e4567-e89b-42d3-a456-426614174002" \
--header "xi-api-key: $BREEZE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"expected_edit_token": "replace_with_current_edit_token",
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"move_to_chapter_id": "123e4567-e89b-42d3-a456-426614174005"
}'from breeze_blue import BreezeBlue
client = BreezeBlue()
result = client.studio.chapters.delete("prj_example", "123e4567-e89b-42d3-a456-426614174002", {
"expected_edit_token": "replace_with_current_edit_token",
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"move_to_chapter_id": "123e4567-e89b-42d3-a456-426614174005",
})import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient();
const result = await client.studio.chapters.delete("prj_example", "123e4567-e89b-42d3-a456-426614174002", {
expectedEditToken: "replace_with_current_edit_token",
operationId: "123e4567-e89b-42d3-a456-426614174000",
moveToChapterId: "123e4567-e89b-42d3-a456-426614174005",
});{
"project": {
"id": "<string>",
"title": "<string>",
"description": "<string>",
"tts_settings": {
"model": "<string>",
"language": "<string>",
"generation_language": "<string>",
"guidance_scale": 123
},
"default_voice_id": "<string>",
"default_instructions": "<string>",
"default_silence_ms": 123,
"edit_token": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"chapter_count": 123,
"clip_count": 123
},
"edit_token": "<string>",
"client_refs": {},
"created_ids": [
"<string>"
]
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}Delete a chapter
Delete a chapter so it can be restored later. Set move_to_chapter_id to keep its clips by moving them to another chapter first; otherwise they stay in the deleted chapter. A project keeps at least one active chapter.
curl \
--request DELETE \
--url "https://api.breeze.blue/v1/studio/projects/prj_example/chapters/123e4567-e89b-42d3-a456-426614174002" \
--header "xi-api-key: $BREEZE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"expected_edit_token": "replace_with_current_edit_token",
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"move_to_chapter_id": "123e4567-e89b-42d3-a456-426614174005"
}'from breeze_blue import BreezeBlue
client = BreezeBlue()
result = client.studio.chapters.delete("prj_example", "123e4567-e89b-42d3-a456-426614174002", {
"expected_edit_token": "replace_with_current_edit_token",
"operation_id": "123e4567-e89b-42d3-a456-426614174000",
"move_to_chapter_id": "123e4567-e89b-42d3-a456-426614174005",
})import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient();
const result = await client.studio.chapters.delete("prj_example", "123e4567-e89b-42d3-a456-426614174002", {
expectedEditToken: "replace_with_current_edit_token",
operationId: "123e4567-e89b-42d3-a456-426614174000",
moveToChapterId: "123e4567-e89b-42d3-a456-426614174005",
});{
"project": {
"id": "<string>",
"title": "<string>",
"description": "<string>",
"tts_settings": {
"model": "<string>",
"language": "<string>",
"generation_language": "<string>",
"guidance_scale": 123
},
"default_voice_id": "<string>",
"default_instructions": "<string>",
"default_silence_ms": 123,
"edit_token": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"chapter_count": 123,
"clip_count": 123
},
"edit_token": "<string>",
"client_refs": {},
"created_ids": [
"<string>"
]
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}Continue building
Manage Studio projects
Move clips
Studio CLI
Authorizations
Breeze Developer API key.
Path Parameters
Studio project ID, such as prj_….
Chapter ID.
Body
edit_token from your latest read or write of this project. A stale token returns 409.
1 - 128New UUID for each write. Retrying with the same ID and body returns the original result instead of repeating the write.
Move the chapter's clips to this active chapter before deleting.
Response
The updated project.
The project after this request.
Show child attributes
Show child attributes
Current edit_token. Send it as expected_edit_token on the next write.
Import only: each client_ref mapped to its created ID.
Show child attributes
Show child attributes
IDs created by this request, in order.

