API referenceScenes

Split a scene in two

at is seconds on the scene clock, or "word:<word>" — the word the second scene starts on.

at is seconds on the scene clock, or "word:<word>" — the word the second scene starts on. A scene anchored in narration keeps its voice: the second scene is anchored at that word in the same block and each takes its own window (seconds snap to the nearest word). Lengths sum to the original. The composition is cloned as is onto the second scene — re-author either one afterwards. Free.

POST
/scenes/{sceneId}/split

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

sceneId*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/scenes/497f6eca-6276-4993-bfeb-53cbbbba6f08/split" \  -H "Content-Type: application/json" \  -d '{    "at": 1  }'
{
  "data": {
    "project_id": "string",
    "changeset_id": "string",
    "dry_run": true,
    "summary": "string",
    "refs": {
      "property1": "string",
      "property2": "string"
    },
    "needs_resolve": {
      "chapters": [
        "string"
      ],
      "scenes": 0
    },
    "new_scene_id": "string"
  }
}
{
  "data": {
    "project_id": "string",
    "changeset_id": "string",
    "dry_run": true,
    "summary": "string",
    "refs": {
      "property1": "string",
      "property2": "string"
    },
    "needs_resolve": {
      "chapters": [
        "string"
      ],
      "scenes": 0
    },
    "new_scene_id": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}