Update Studio Project Metadata — ElevenLabs Documentation

Updates Studio project metadata.

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 Studio 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 Studio project, this will be added as metadata to the mp3 file on Studio project or chapter download.

authorstringOptional

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

isbn_numberstringOptional

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

volume_normalizationbooleanOptionalDefaults to false

When the Studio 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/studio/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/studio/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	}