---
title: "Setup Story"
method: POST
path: "/story-setup"
tags: ["APIs", "Stories"]
---

# Setup Story

`POST /story-setup`

## Response `200`

Successful Response

- StorySetupResultResponse
  - `run_id` integer — The unique identifier for the run, which was generated during the Story setup process and returned upon task completion.
  - `story_details` StoryDetails
    - `story_title` string — This represents the human-readable project identifier for your story project. Think of this as the project's display name that appears throughout CAMB.AI Studio, helping you and your team quickly identify which story content you're working with during the story creation process.
    - `story_description` string, nullable — This field contains the detailed project context and story synopsis you provided during setup, serving as documentation that travels with your audiobook project throughout its lifecycle. The description becomes particularly valuable for understanding the story's context, genre, and target audience when projects move between team members or when you return to work after time has passed.
    - `created_at` string, date-time — This timestamp in UTC timezone marks the exact moment your story project setup was initiated, providing crucial information for workflow coordination and project management throughout the narration process.
    - `source_language` string
    - `target_languages` LanguageInput[] — Languages to generate output in. Pass locale tags (`es-es`, `fr-fr`, `de-de`). Numeric language IDs still work but are deprecated. [See all target languages](/api-reference/endpoint/get-target-languages).
    - `folder_id` integer, nullable — This optional field indicates the organizational folder where your story resides within your team's workspace structure. Think of this as your project's filing location within CAMB.AI Studio, helping maintain organized project management as your audiobook library grows and you manage multiple story projects.
    - `studio_url` string — This field contains the direct URL link to access your audiobook project within CAMB.AI Studio's web interface. Once your project setup is complete, this URL serves as the primary entry point for all creative work, allowing you and your team members to navigate directly to the project's workspace where you can review generated audio, adjust narrator settings, refine pronunciation guides, manage chapter breaks, and oversee the entire audiobook production process.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/camb/apis/fastapi.md) · [All operations](https://skmtc.net/camb/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/camb/fastapi/versions/40ebeee64850/schema)