API referenceScenes
List the saved versions (takes) of a scene
A take is a frozen copy of a scene's composition (script, metadata, captions, thumbnail).
Returns each take newest first with its label, kind (manual, or auto when taken by a switch so nothing is lost), title, length and thumbnail, and which one the scene is right now. Scripts are never returned. Free.
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
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/scenes/497f6eca-6276-4993-bfeb-53cbbbba6f08/takes"{
"data": {
"scene_id": "string",
"takes": [
{
"id": "string",
"label": "string",
"note": "string",
"kind": "manual",
"active": true,
"title": "string",
"duration_sec": 0,
"thumbnail_url": "string",
"created_at": "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"
}
}