Update Studio Project

curl -X POST https://api.elevenlabs.io/v1/studio/projects/project_id \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Project 1",
  "default_title_voice_id": "21m00Tcm4TlvDq8ikWAM",
  "default_paragraph_voice_id": "21m00Tcm4TlvDq8ikWAM"
}'

{
  "project": {
    "project_id": "aw1NgEzBg83R7vgmiJt6",
    "name": "My Project",
    "create_date_unix": 1714204800,
    "created_by_user_id": "Vbtgl3bRdj6lk79rYAgx",
    "default_title_voice_id": "JBFqnCBsd6RMkjVDRZzb",
    "default_paragraph_voice_id": "JBFqnCBsd6RMkjVDRZzb",
    "default_model_id": "eleven_multilingual_v2",
    "can_be_downloaded": true,
    "volume_normalization": true,
    "state": "default",
    "access_level": "viewer",
    "quality_check_on": false,
    "quality_check_on_when_bulk_convert": false,
    "last_conversion_date_unix": 1714204800,
    "title": "My Project",
    "author": "John Doe",
    "description": "This is a description of my project.",
    "genres": [
      "Novel",
      "Short Story"
    ],
    "cover_image_url": "https://example.com/cover.jpg",
    "target_audience": "young adult",
    "language": "en",
    "content_type": "Novel",
    "original_publication_date": "2025-01-01",
    "mature_content": false,
    "isbn_number": "978-90-274-3964-2",
    "fiction": "fiction",
    "creation_meta": {
      "creation_progress": 0.5,
      "status": "pending",
      "type": "blank"
    },
    "public_share_id": "abc123def456789"
  }
}

Updates the specified Studio project by setting the values of the parameters passed.

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.

titlestring or nullOptional

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.

authorstring or nullOptional

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_numberstring or nullOptional

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

422

Unprocessable Entity Error

Path parameters

Headers

Request

Response

Errors

Path parameters

Headers

Request

Response

Errors