Update Chapter

POST

/v1/studio/projects/:project_id/chapters/:chapter_id

Updates a chapter.

Path parameters

project_idstringRequired

The ID of the project to be used. You can use the List projects endpoint to list all the available projects.

chapter_idstringRequired

The ID of the chapter to be used. You can use the List project chapters endpoint to list all the available chapters.

Request

This endpoint expects an object.

namestringOptional

The name of the chapter, used for identification only.

contentobjectOptional

The chapter content to use.

Response

Successful Response

chapterobject

Errors

POST

1 curl -X POST https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/chapters/21m00Tcm4TlvDq8ikWAM \
2      -H "xi-api-key: <apiKey>" \
3      -H "Content-Type: application/json" \
4      -d '{}'

200Successful

1 {
2   "chapter": {
3     "chapter_id": "aw1NgEzBg83R7vgmiJt6",
4     "name": "Chapter 1",
5     "can_be_downloaded": true,
6     "state": "converting",
7     "content": {
8       "blocks": [
9         {
10           "block_id": "block_id",
11           "nodes": [
12             {
13               "type": "tts_node",
14               "text": "text",
15               "voice_id": "voice_id"
16             }
17           ]
18         }
19       ]
20     },
21     "last_conversion_date_unix": 1714204800,
22     "conversion_progress": 0.5,
23     "statistics": {
24       "characters_unconverted": 1000,
25       "characters_converted": 500,
26       "paragraphs_converted": 20,
27       "paragraphs_unconverted": 10
28     },
29     "last_conversion_error": "Error message"
30   }
31 }

Delete Chapter

Up Next

Built with

1	curl -X POST https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/chapters/21m00Tcm4TlvDq8ikWAM \
2	-H "xi-api-key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{}'

1	{
2	"chapter": {
3	"chapter_id": "aw1NgEzBg83R7vgmiJt6",
4	"name": "Chapter 1",
5	"can_be_downloaded": true,
6	"state": "converting",
7	"content": {
8	"blocks": [
9	{
10	"block_id": "block_id",
11	"nodes": [
12	{
13	"type": "tts_node",
14	"text": "text",
15	"voice_id": "voice_id"
16	}
17	]
18	}
19	]
20	},
21	"last_conversion_date_unix": 1714204800,
22	"conversion_progress": 0.5,
23	"statistics": {
24	"characters_unconverted": 1000,
25	"characters_converted": 500,
26	"paragraphs_converted": 20,
27	"paragraphs_unconverted": 10
28	},
29	"last_conversion_error": "Error message"
30	}
31	}