Edits a scene's content: imagePrompt, animationPrompt,
narration, voiceDescription or duration (5 to 20 seconds, or 3 to
20 when clamped). Provide at least one.
Every editable field is content, so the scene's rendered clip and the
stitched video both become stale: videoUrl on the scene and
renderUrl on the video are cleared. Regenerate the still with
POST /videos/{id}/scenes/{sceneId}/image and re-render afterwards.
Authorization
bearerAuth An API key created under Settings > API & Webhooks. Keys start with sf_live_.
In: header
Path Parameters
The scene's id, as returned in the scenes array.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
The editable fields of an AI scene. Provide at least one.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/videos/string/scenes/string" \ -H "Content-Type: application/json" \ -d '{ "narration": "Most founders burn out from never finishing anything.", "duration": 7 }'{ "data": { "imagePrompt": "string", "animationPrompt": "string", "narration": "string", "voiceDescription": "string", "duration": 3, "id": "string", "status": "string", "imageUrl": "http://example.com", "videoUrl": "http://example.com" }}Reset the theme config DELETE
Replaces the stored config with the editor defaults and returns them.
Merge keys into the theme config PATCH
Shallow-merges the keys the body carries into the stored config and returns the whole merged object. Keys the body omits are left alone. The body may be the config object itself or the same object nested under `config`. Unknown keys are dropped; a known key with a value outside its enum or range is a `400`. A body that carries no known config key at all is refused rather than saved as a no-op.