apicheats.dev elevenlabs/llms.txt Raw .md
POST

/v1/studio/projects/{project_id}/content

ElevenLabs API

Update Studio Project Content

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
→ 216 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/content' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -F 'from_url=string' \  -F 'from_document=@sample.bin' \  -F 'from_content_json=string' \  -F 'auto_convert=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.
from_url body string No An optional URL from which we will extract content to initialize the Studio project. If this is set, 'from_url' and 'from_content' must be null. If neither 'from_url', 'from_document', 'from_content' are provided we will initialize the Studio project as blank.
from_document body string No An optional .epub, .pdf, .txt or similar file can be provided. If provided, we will initialize the Studio project with its content. If this is set, 'from_url' and 'from_content' must be null. If neither 'from_url', 'from_document', 'from_content' are provided we will initialize the Studio project as blank.
from_content_json body string No An optional content to initialize the Studio project with. If this is set, 'from_url' and 'from_document' must be null. If neither 'from_url', 'from_document', 'from_content' are provided we will initialize the Studio project as blank. Example: [{"name": "Chapter A", "blocks": [{"sub_type": "p", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "A", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "B", "type": "tts_node"}]}, {"sub_type": "h1", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "C", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "D", "type": "tts_node"}]}]}, {"name": "Chapter B", "blocks": [{"sub_type": "p", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "E", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "F", "type": "tts_node"}]}, {"sub_type": "h2", "nodes": [{"voice_id": "6lCwbsX1yVjD49QmpkT0", "text": "G", "type": "tts_node"}, {"voice_id": "6lCwbsX1yVjD49QmpkT1", "text": "H", "type": "tts_node"}]}]}]
auto_convert body boolean No Whether to auto convert the Studio project to audio or not.

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
  }
}