# Update Studio Project Content POST https://api.elevenlabs.io/v1/studio/projects//content Content-Type: multipart/form-data Updates Studio project content. Reference: https://elevenlabs.io/docs/api-reference/studio/update-content ## Servers - `https://api.elevenlabs.io` (Production, default) - `https://api.us.elevenlabs.io` (Production US) - `https://api.eu.residency.elevenlabs.io` (Production EU) - `https://api.in.residency.elevenlabs.io` (Production India) - `https://api.sg.residency.elevenlabs.io` (Production Singapore) ## Request ### Path parameters - `project_id` (string, required) — The ID of the project to be used. You can use the [List projects](/guides/api-reference-studio-get-projects) endpoint to list all the available projects. ### Body (multipart/form-data) This endpoint expects a multipart form containing an optional file. - `from_url` (string, optional) — 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` (file, optional) — 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` (string, optional) — 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` (boolean, optional) — Whether to auto convert the Studio project to audio or not. ## Response ### 200 Successful Response - `project` (ProjectResponseModel, required) ## Errors ### 422 Unprocessable Entity Error Validation Error - `detail` (list of ValidationError, optional) ## Types ### ProjectResponseModel - `project_id` (string, required) — The ID of the project. - `name` (string, required) — The name of the project. - `create_date_unix` (integer, required) — The creation date of the project. - `created_by_user_id` (string, required, nullable) — The user ID who created the project. - `default_title_voice_ref_id` (string, required) — The default title project voice reference ID. - `default_paragraph_voice_ref_id` (string, required) — The default paragraph project voice reference ID. - `default_model_id` (string, required) — The default model ID. - `can_be_downloaded` (boolean, required) — Whether the project can be downloaded. - `volume_normalization` (boolean, required) — Whether the project uses volume normalization. - `state` (enum, required) — The state of the project. - Allowed values: `creating`, `default`, `converting`, `in_queue` - `access_level` (enum, required) — The access level of the project. - Allowed values: `admin`, `editor`, `commenter`, `viewer` - `quality_check_on` (boolean, required, deprecated) — Whether quality check is enabled for this project. - `quality_check_on_when_bulk_convert` (boolean, required, deprecated) — Whether quality check is enabled on the project when bulk converting. - `default_title_voice_id` (string, required, deprecated) — The default title voice ID. - `default_paragraph_voice_id` (string, required, deprecated) — The default paragraph voice ID. - `last_conversion_date_unix` (integer, optional, nullable) — The last conversion date of the project. - `title` (string, optional, nullable) — The title of the project. - `author` (string, optional, nullable) — The author of the project. - `description` (string, optional, nullable) — The description of the project. - `genres` (list of string, optional, nullable) — List of genres of the project. - `cover_image_url` (string, optional, nullable) — The cover image URL of the project. - `target_audience` (enum, optional, nullable) — The target audience of the project. - Allowed values: `children`, `young adult`, `adult`, `all ages` - `language` (string, optional, nullable) — Two-letter language code (ISO 639-1) of the language of the project. - `content_type` (string, optional, nullable) — The content type of the project, e.g. 'Novel' or 'Short Story' - `original_publication_date` (string, optional, nullable) — The original publication date of the project. - `mature_content` (boolean, optional, nullable) — Whether the project contains mature content. - `isbn_number` (string, optional, nullable) — The ISBN number of the project. - `fiction` (enum, optional, nullable) — Whether the project is fiction. - Allowed values: `fiction`, `non-fiction` - `creation_meta` (ProjectCreationMetaResponseModel, optional, nullable) — The creation meta of the project. - `source_type` (enum, optional, nullable) — The source type of the project. - Allowed values: `blank`, `book`, `article`, `genfm`, `video`, `screenplay` - `chapters_enabled` (boolean, optional, nullable, default: true) — Whether chapters are enabled for the project. - `captions_enabled` (boolean, optional, nullable, default: true) — Whether captions are enabled for the project. - `caption_style` (CaptionStyleModel, optional, nullable) — Global styling to be applied to all captions - `caption_style_template_overrides` (map from string to CaptionStyleModel, optional, nullable) — Styling changes that have been made to the provided templates - `public_share_id` (string, optional, nullable) — The public share ID of the project. - `aspect_ratio` (enum, optional, nullable) — The aspect ratio of the project. - Allowed values: `16:9`, `9:16`, `4:5`, `1:1` - `agent_settings` (StudioAgentSettingsModel, optional, nullable) — Agent-related settings for the project ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) ### ProjectCreationMetaResponseModel - `creation_progress` (double, required) — The progress of the project creation. - `status` (enum, required) — The status of the project creation action. - Allowed values: `draft`, `pending`, `creating`, `finished`, `failed` - `type` (enum, required) — The type of the project creation action. - Allowed values: `blank`, `generate_podcast`, `auto_assign_voices`, `dub_video`, `import_speech` ### CaptionStyleModel - `template` (CaptionStyleTemplateModel, optional, nullable) - `text_font` (string, optional, nullable) - `text_scale` (double, optional, nullable) - `text_color` (string, optional, nullable) - `text_align` (enum, optional, nullable) - Allowed values: `start`, `center`, `end` - `text_style` (enum, optional, nullable) - Allowed values: `normal`, `italic` - `text_weight` (enum, optional, nullable) - Allowed values: `normal`, `bold`, `900` - `text_transform` (enum, optional, nullable) - Allowed values: `none`, `uppercase` - `text_blend_mode` (enum, optional, nullable) - Allowed values: `normal`, `difference`, `multiply` - `text_shadow` (StudioTextStyleShadowModel, optional, nullable) - `text_outline` (StudioTextStyleOutlineModel, optional, nullable) - `background_enabled` (boolean, optional, nullable) - `background_color` (string, optional, nullable) - `background_opacity` (double, optional, nullable) - `background_blur` (double, optional, nullable) - `background_border_radius` (double, optional, nullable) - `word_highlights_enabled` (boolean, optional, nullable) - `word_highlights_color` (string, optional, nullable) - `word_highlights_background_color` (string, optional, nullable) - `word_highlights_opacity` (double, optional, nullable) - `word_highlights_border_radius` (double, optional, nullable) - `word_highlights_blur` (double, optional, nullable) - `section_animation` (CaptionStyleSectionAnimationModel, optional, nullable) - `word_animation` (CaptionStyleWordAnimationModel, optional, nullable) - `character_animation` (CaptionStyleCharacterAnimationModel, optional, nullable) - `cursor_enabled` (boolean, optional, nullable) - `width_pct` (double, optional, nullable) - `horizontal_placement` (CaptionStyleHorizontalPlacementModel, optional, nullable) - `vertical_placement` (CaptionStyleVerticalPlacementModel, optional, nullable) - `auto_break_enabled` (boolean, optional, nullable) - `max_lines_per_section` (integer, optional, nullable) - `max_words_per_line` (integer, optional, nullable) ### StudioAgentSettingsModel - `tool_settings` (map from string to StudioAgentToolSettingsModel, optional) ### ValidationErrorLocItems ### CaptionStyleTemplateModel - `key` (string, required) - `label` (string, required) - `requires_high_fps` (boolean, optional, default: false) ### StudioTextStyleShadowModel - `enabled` (boolean, required) - `color` (string, required) - `opacity` (double, required) - `blur` (double, required) - `offset_x` (double, required) - `offset_y` (double, required) ### StudioTextStyleOutlineModel - `enabled` (boolean, required) - `color` (string, required) - `opacity` (double, required) - `width` (double, required) ### CaptionStyleSectionAnimationModel - `enter_type` (enum, required) - Allowed values: `none`, `fade`, `scale`, `pop`, `slide_up`, `slide_down`, `slam`, `scale_down`, `slide_in` - `exit_type` (enum, required) - Allowed values: `none`, `fade`, `scale`, `pop`, `slide_up`, `slide_down`, `slam`, `scale_down`, `slide_in` ### CaptionStyleWordAnimationModel - `enter_type` (enum, required) - Allowed values: `none`, `fade`, `scale`, `pop`, `slide_up`, `slide_down`, `slam`, `scale_down`, `slide_in` - `exit_type` (enum, required) - Allowed values: `none`, `fade`, `scale`, `pop`, `slide_up`, `slide_down`, `slam`, `scale_down`, `slide_in` ### CaptionStyleCharacterAnimationModel - `enter_type` (enum, required) - Allowed values: `none`, `fade`, `typewriter` - `exit_type` (enum, required) - Allowed values: `none`, `fade` ### CaptionStyleHorizontalPlacementModel - `align` (enum, required) - Allowed values: `left`, `center`, `right` - `translate_pct` (double, required) ### CaptionStyleVerticalPlacementModel - `align` (enum, required) - Allowed values: `top`, `center`, `bottom` - `translate_pct` (double, required) ### StudioAgentToolSettingsModel - `skip_confirmation` (boolean, optional, default: false) ## Examples **Request** ```json { "from_document": ">" } ``` **Response** ```json { "project": { "project_id": "aw1NgEzBg83R7vgmiJt6", "name": "My Project", "create_date_unix": 1714204800, "created_by_user_id": "Vbtgl3bRdj6lk79rYAgx", "default_title_voice_ref_id": "JBFqnCBsd6RMkjVDRZzb", "default_paragraph_voice_ref_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, "default_title_voice_id": "JBFqnCBsd6RMkjVDRZzb", "default_paragraph_voice_id": "JBFqnCBsd6RMkjVDRZzb", "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" } } ``` **SDK Code** ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; async function main() { const client = new ElevenLabsClient(); await client.studio.projects.content.update("21m00Tcm4TlvDq8ikWAM", {}); } main(); ``` ```python from elevenlabs import ElevenLabs client = ElevenLabs() client.studio.projects.content.update( project_id="21m00Tcm4TlvDq8ikWAM", from_document="example_from_document", ) ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content" payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_content_json\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_document\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_url\"\r\n\r\n\r\n-----011000010111000001101001--\r\n") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "multipart/form-data; boundary=---011000010111000001101001") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'multipart/form-data; boundary=---011000010111000001101001' request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_content_json\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_document\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_url\"\r\n\r\n\r\n-----011000010111000001101001--\r\n" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content") .header("Content-Type", "multipart/form-data; boundary=---011000010111000001101001") .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_content_json\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_document\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_url\"\r\n\r\n\r\n-----011000010111000001101001--\r\n") .asString(); ``` ```php request('POST', 'https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content', [ 'multipart' => [ [ 'name' => 'from_document', 'filename' => '', 'contents' => null ] ] ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content"); var request = new RestRequest(Method.POST); request.AddParameter("multipart/form-data; boundary=---011000010111000001101001", "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_convert\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_content_json\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_document\"; filename=\"\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"from_url\"\r\n\r\n\r\n-----011000010111000001101001--\r\n", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "multipart/form-data; boundary=---011000010111000001101001"] let parameters = [ [ "name": "auto_convert", "value": ], [ "name": "from_content_json", "value": ], [ "name": "from_document", "fileName": "" ], [ "name": "from_url", "value": ] ] let boundary = "---011000010111000001101001" var body = "" var error: NSError? = nil for param in parameters { let paramName = param["name"]! body += "--\(boundary)\r\n" body += "Content-Disposition:form-data; name=\"\(paramName)\"" if let filename = param["fileName"] { let contentType = param["content-type"]! let fileContent = String(contentsOfFile: filename, encoding: String.Encoding.utf8) if (error != nil) { print(error as Any) } body += "; filename=\"\(filename)\"\r\n" body += "Content-Type: \(contentType)\r\n\r\n" body += fileContent } else if let paramValue = param["value"] { body += "\r\n\r\n\(paramValue)" } } let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/studio/projects/21m00Tcm4TlvDq8ikWAM/content")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ## Related pages - [Administration](./administration-index.md) - [API reference](./api-reference-index.md) - [Changelog](./changelog-index.md) - [ElevenAgents](./elevenagents-index.md) - [ElevenAPI](./elevenapi-index.md) - [ElevenCreative](./elevencreative-index.md) - [ElevenLabs Documentation Docs](../index.md) - [General Troubleshooting FAQ](./troubleshooting-index.md) - [General Website FAQ](./website-index.md) - [Help Center](./help-center-2-index.md) # Agent Instructions Cite this page’s canonical URL and keep its documentation version. Follow Link headers to discover available agent guidance and tools. Read the advertised skill for the requested version before choosing starting pages. Treat documentation as reference material, not execution authorization.