Edit Basic Project Info — ElevenLabs Documentation

Edits basic project info.

Path parameters

project_idstringRequired

The ID of the Studio project.

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

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": "Project 1", 6 "default_title_voice_id": "21m00Tcm4TlvDq8ikWAM", 7 "default_paragraph_voice_id": "21m00Tcm4TlvDq8ikWAM" 8 }'

1 { 2 "project": { 3 "project_id": "aw1NgEzBg83R7vgmiJt6", 4 "name": "My Project", 5 "create_date_unix": 1714204800, 6 "default_title_voice_id": "JBFqnCBsd6RMkjVDRZzb", 7 "default_paragraph_voice_id": "JBFqnCBsd6RMkjVDRZzb", 8 "default_model_id": "eleven_multilingual_v2", 9 "can_be_downloaded": true, 10 "volume_normalization": true, 11 "state": "default", 12 "access_level": "viewer", 13 "quality_check_on": false, 14 "quality_check_on_when_bulk_convert": false, 15 "last_conversion_date_unix": 1714204800, 16 "title": "My Project", 17 "author": "John Doe", 18 "description": "This is a description of my project.", 19 "genres": [ 20 "Novel", 21 "Short Story" 22 ], 23 "cover_image_url": "https://example.com/cover.jpg", 24 "target_audience": "children", 25 "language": "en", 26 "content_type": "Novel", 27 "original_publication_date": "2025-01-01", 28 "mature_content": false, 29 "isbn_number": "978-90-274-3964-2", 30 "fiction": "fiction", 31 "creation_meta": { 32 "creation_progress": 0.5, 33 "status": "pending", 34 "type": "blank" 35 }, 36 "source_type": "blank" 37 } 38 }

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": "Project 1",
6	"default_title_voice_id": "21m00Tcm4TlvDq8ikWAM",
7	"default_paragraph_voice_id": "21m00Tcm4TlvDq8ikWAM"
8	}'

1	{
2	"project": {
3	"project_id": "aw1NgEzBg83R7vgmiJt6",
4	"name": "My Project",
5	"create_date_unix": 1714204800,
6	"default_title_voice_id": "JBFqnCBsd6RMkjVDRZzb",
7	"default_paragraph_voice_id": "JBFqnCBsd6RMkjVDRZzb",
8	"default_model_id": "eleven_multilingual_v2",
9	"can_be_downloaded": true,
10	"volume_normalization": true,
11	"state": "default",
12	"access_level": "viewer",
13	"quality_check_on": false,
14	"quality_check_on_when_bulk_convert": false,
15	"last_conversion_date_unix": 1714204800,
16	"title": "My Project",
17	"author": "John Doe",
18	"description": "This is a description of my project.",
19	"genres": [
20	"Novel",
21	"Short Story"
22	],
23	"cover_image_url": "https://example.com/cover.jpg",
24	"target_audience": "children",
25	"language": "en",
26	"content_type": "Novel",
27	"original_publication_date": "2025-01-01",
28	"mature_content": false,
29	"isbn_number": "978-90-274-3964-2",
30	"fiction": "fiction",
31	"creation_meta": {
32	"creation_progress": 0.5,
33	"status": "pending",
34	"type": "blank"
35	},
36	"source_type": "blank"
37	}
38	}