curl -X POST 'https://api.elevenlabs.io/v1/studio/projects/project-id' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "default_title_voice_id": "string",
  "default_paragraph_voice_id": "string",
  "title": "string",
  "author": "string",
  "isbn_number": "string",
  "volume_normalization": false
}'

# POST /v1/studio/projects/{project_id} (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Update Studio Project

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X POST 'https://api.elevenlabs.io/v1/studio/projects/project-id' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name":"string","default_title_voice_id":"string"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| project_id | path | string | Yes | The ID of the Studio project. |
| name | body | string | Yes | The name of the Studio project, used... |
| default_title_voice_id | body | string | Yes | The voice_id that corresponds to the... |

## Response (200 OK)
{"project":{"access_level":"viewer","author":"John Doe"}}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

POST

/v1/studio/projects/{project_id}

ElevenLabs API

Update Studio Project

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 214 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X POST 'https://api.elevenlabs.io/v1/studio/projects/project-id' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "default_title_voice_id": "string",  "default_paragraph_voice_id": "string",  "title": "string",  "author": "string",  "isbn_number": "string",  "volume_normalization": false}'

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
project_id	path	string	Yes	The ID of the Studio project.
name	body	string	Yes	The name of the Studio project, used for identification only.
default_title_voice_id	body	string	Yes	The voice_id that corresponds to the default voice used for new titles.
default_paragraph_voice_id	body	string	Yes	The voice_id that corresponds to the default voice used for new paragraphs.
title	body	string	No	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.
author	body	string	No	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_number	body	string	No	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_normalization	body	boolean	No	When the Studio project is downloaded, should the returned audio have postprocessing in order to make it compliant with audiobook normalized volume requirements

Response 200 OK

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