Docs
Log inStart free
API referenceChapters

Reorder a chapter's scenes

Set the full scene order.

The body must list EVERY non-deleted scene id in the chapter exactly once — full-order semantics, so a stale caller cannot silently interleave with a concurrent edit.

POST
/chapters/{chapterId}/reorder-scenes

Authorization

bearerAuth
AuthorizationBearer <token>

Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….

In: header

Path Parameters

chapterId*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/chapters/497f6eca-6276-4993-bfeb-53cbbbba6f08/reorder-scenes" \  -H "Content-Type: application/json" \  -d '{    "scene_ids": [      "string"    ]  }'
{
  "data": {
    "chapter_id": "88d12d31-77f2-44df-910e-b37f83274f80",
    "order": [
      "string"
    ]
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

Set the pauses of a script block PUT

Set a block's pacing: a pause is SILENCE inserted into the voice-over timeline at a point in the text, so the words after it are heard later (the editor's pause chips).

Export a chapter as one embeddable sequence POST

Publish a whole chapter as ONE embeddable block: its scenes play back to back on one clock, mounted a window at a time (WebGL, Pixi and project modules included), with the chapter voice and the project music carried across scene boundaries.