Update project — ElevenLabs Documentation

Edits basic project info.

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.

Request

This endpoint expects an object.

namestringRequired

The name of the project, used for identification only.

default_title_voice_idstringRequired

The voice_id that corresponds to the default voice used for new titles.

default_paragraph_voice_idstringRequired

The voice_id that corresponds to the default voice used for new paragraphs.

titlestringOptional

An optional name of the author of the project, this will be added as metadata to the mp3 file on project / chapter download.

authorstringOptional

An optional name of the author of the project, this will be added as metadata to the mp3 file on project / chapter download.

isbn_numberstringOptional

An optional ISBN number of the project you want to create, this will be added as metadata to the mp3 file on project / chapter download.

volume_normalizationbooleanOptionalDefaults to false

When the project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements

quality_check_onbooleanOptional

[Depracated] Whether to run quality check on the generated audio and regenerate if needed. Applies to individual block conversion.

Response

Successful Response

projectobject

Errors

1 curl -X POST https://api.elevenlabs.io/v1/projects/21m00Tcm4TlvDq8ikWAM \ 2 -H "xi-api-key: <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "name": "name", 6 "default_title_voice_id": "default_title_voice_id", 7 "default_paragraph_voice_id": "default_paragraph_voice_id" 8 }'

1 { 2 "project": { 3 "project_id": "project_id", 4 "name": "name", 5 "create_date_unix": 1, 6 "default_title_voice_id": "default_title_voice_id", 7 "default_paragraph_voice_id": "default_paragraph_voice_id", 8 "default_model_id": "default_model_id", 9 "can_be_downloaded": true, 10 "volume_normalization": true, 11 "state": "creating", 12 "access_level": "admin", 13 "quality_check_on": true, 14 "quality_check_on_when_bulk_convert": true, 15 "last_conversion_date_unix": 1, 16 "title": "title", 17 "author": "author", 18 "description": "description", 19 "genres": [ 20 "genres" 21 ], 22 "cover_image_url": "cover_image_url", 23 "target_audience": "children", 24 "language": "language", 25 "content_type": "content_type", 26 "original_publication_date": "original_publication_date", 27 "mature_content": true, 28 "isbn_number": "isbn_number", 29 "fiction": "fiction", 30 "creation_meta": { 31 "creation_progress": 1.1, 32 "status": "pending", 33 "type": "blank" 34 } 35 } 36 }

1	curl -X POST https://api.elevenlabs.io/v1/projects/21m00Tcm4TlvDq8ikWAM \
2	-H "xi-api-key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "name",
6	"default_title_voice_id": "default_title_voice_id",
7	"default_paragraph_voice_id": "default_paragraph_voice_id"
8	}'

1	{
2	"project": {
3	"project_id": "project_id",
4	"name": "name",
5	"create_date_unix": 1,
6	"default_title_voice_id": "default_title_voice_id",
7	"default_paragraph_voice_id": "default_paragraph_voice_id",
8	"default_model_id": "default_model_id",
9	"can_be_downloaded": true,
10	"volume_normalization": true,
11	"state": "creating",
12	"access_level": "admin",
13	"quality_check_on": true,
14	"quality_check_on_when_bulk_convert": true,
15	"last_conversion_date_unix": 1,
16	"title": "title",
17	"author": "author",
18	"description": "description",
19	"genres": [
20	"genres"
21	],
22	"cover_image_url": "cover_image_url",
23	"target_audience": "children",
24	"language": "language",
25	"content_type": "content_type",
26	"original_publication_date": "original_publication_date",
27	"mature_content": true,
28	"isbn_number": "isbn_number",
29	"fiction": "fiction",
30	"creation_meta": {
31	"creation_progress": 1.1,
32	"status": "pending",
33	"type": "blank"
34	}
35	}
36	}