studio

Update Studio Project Content

Changed on Jul 26, 2026

Updates Studio project content.

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

Request

Base URL
https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
URL
https://api.elevenlabs.io/v1/studio/projects/{project_id}/content
Auth
none declared

Path parameters

project_idstring required

The ID of the Studio project.

Example:21m00Tcm4TlvDq8ikWAM

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Request body multipart/form-data

from_urlstring nullable

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_documentstring binary nullable

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_jsonstring

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_convertboolean

Whether to auto convert the Studio project to audio or not.

Example request

{
  "from_url": "https://blog.elevenlabs.io/the_first_ai_that_can_laugh/",
  "from_content_json": "[{\"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\"}]}]}]"
}

Response

Successful Response

Example response

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

Changes

Jul 26, 2026494d96419d15 Revision changes
- warning
  added the new draft enum value to the /// response property for the response status
Jul 13, 2026009bd651509a Revision changes
- warning
  added the new pop enum value to the ///// response property for the response status
- warning
  added the new pop enum value to the ///// response property for the response status
- warning
  added the new pop enum value to the ///// response property for the response status
- warning
  added the new pop enum value to the ///// response property for the response status
- warning
  added the new pop enum value to the ////// response property for the response status
- warning
  added the new pop enum value to the ////// response property for the response status
- warning
  added the new pop enum value to the ////// response property for the response status
- warning
  added the new pop enum value to the ////// response property for the response status
- warning
  added the new scale_down enum value to the ///// response property for the response status
- warning
  added the new scale_down enum value to the ///// response property for the response status
- warning
  added the new scale_down enum value to the ///// response property for the response status
- warning
  added the new scale_down enum value to the ///// response property for the response status
- warning
  added the new scale_down enum value to the ////// response property for the response status
- warning
  added the new scale_down enum value to the ////// response property for the response status
- warning
  added the new scale_down enum value to the ////// response property for the response status
- warning
  added the new scale_down enum value to the ////// response property for the response status
- warning
  added the new slam enum value to the ///// response property for the response status
- warning
  added the new slam enum value to the ///// response property for the response status
- warning
  added the new slam enum value to the ///// response property for the response status
- warning
  added the new slam enum value to the ///// response property for the response status
- warning
  added the new slam enum value to the ////// response property for the response status
- warning
  added the new slam enum value to the ////// response property for the response status
- warning
  added the new slam enum value to the ////// response property for the response status
- warning
  added the new slam enum value to the ////// response property for the response status
- warning
  added the new slide_down enum value to the ///// response property for the response status
- warning
  added the new slide_down enum value to the ///// response property for the response status
- warning
  added the new slide_down enum value to the ///// response property for the response status
- warning
  added the new slide_down enum value to the ///// response property for the response status
- warning
  added the new slide_down enum value to the ////// response property for the response status
- warning
  added the new slide_down enum value to the ////// response property for the response status
- warning
  added the new slide_down enum value to the ////// response property for the response status
- warning
  added the new slide_down enum value to the ////// response property for the response status
- warning
  added the new slide_in enum value to the ///// response property for the response status
- warning
  added the new slide_in enum value to the ///// response property for the response status
- warning
  added the new slide_in enum value to the ///// response property for the response status
- warning
  added the new slide_in enum value to the ///// response property for the response status
- warning
  added the new slide_in enum value to the ////// response property for the response status
- warning
  added the new slide_in enum value to the ////// response property for the response status
- warning
  added the new slide_in enum value to the ////// response property for the response status
- warning
  added the new slide_in enum value to the ////// response property for the response status
- warning
  added the new slide_up enum value to the ///// response property for the response status
- warning
  added the new slide_up enum value to the ///// response property for the response status
- warning
  added the new slide_up enum value to the ///// response property for the response status
- warning
  added the new slide_up enum value to the ///// response property for the response status
- warning
  added the new slide_up enum value to the ////// response property for the response status
- warning
  added the new slide_up enum value to the ////// response property for the response status
- warning
  added the new slide_up enum value to the ////// response property for the response status
- warning
  added the new slide_up enum value to the ////// response property for the response status
- warning
  added the new typewriter enum value to the ///// response property for the response status
- warning
  added the new typewriter enum value to the ////// response property for the response status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  response property project/default_paragraph_voice_id deprecated
- info
  response property project/default_title_voice_id deprecated
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  the response required property / became read-only for the status
- info
  the response required property / became read-only for the status

Operation history (5 revisions)