API referenceScenes

Get a scene

Read one scene in full, including its composition and composition_version.

Read one scene in full, including its composition and composition_version. Read a scene before rewriting it — patches address the source by line number.

GET
/scenes/{sceneId}

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

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/scenes/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "chapter_id": "88d12d31-77f2-44df-910e-b37f83274f80",
    "title": "string",
    "prompt": "string",
    "sequence_order": 0,
    "media_source": "string",
    "duration": 0,
    "generation_status": "string",
    "content_status": "string",
    "block_id": "string",
    "captions_enabled": true,
    "caption_style_id": "string",
    "background": null,
    "composition_version": 0
  }
}
{
  "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"
  }
}