API referenceScenes
Copy scenes into another project, by reference
Copies scene_ids (or every scene of chapter_id) from from_project into to_project.
The composition is shared by its immutable url (pinned modules and linked kernels included), so nothing is pasted and the call stays small. Carries metadata, entry/exit state, length, title and the scene's own sound (include_sound false drops it); narration and voice stay behind. Needs read on the source and write on the target. Lands in to_chapter_id or a new chapter. 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
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/copy" \ -H "Content-Type: application/json" \ -d '{ "from_project": "5e190ae5-d9c2-4625-9ff3-41b07f328fc1", "to_project": "a5c22fe9-2e5e-491b-b57d-eb20d1c5e0c9" }'{
"data": {}
}{
"data": {
"dry_run": true,
"chapter_id": "string",
"created_chapter": true,
"scenes": [
{
"from_scene_id": "string",
"scene_id": "string",
"title": "string",
"duration": 0
}
],
"notes": [
"string"
]
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}