Update shot
update_shotChange one storyboard shot: its action text, framing (shotValue), camera movement, duration, or continuation link. Only the fields you pass change. Get shotIds from list_shots. Live collaborators see the change immediately. No images are regenerated and no credits are spent. A shot that continues another (continuesFromShotId set) takes its framing and camera movement from its chain head: shotValue / cameraMovement passed for it are not applied and come back in ignored; change the chain head instead. Pass continuesFromShotId to link to an earlier shot of the same scene, or null to unlink. At least one field besides shotId is required. Returns the shot as list_shots shows it after the write.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shotId | Yes | Shot to change (shotId from list_shots or create_shots). | |
| projectId | Yes | ScreenWeaver project id (from list_projects). | |
| shotValue | No | Framing. A preset value, label or shorthand: extreme-close-up (ECU), close-up (CU), medium-close-up (MCU), medium (MS), medium-long (MLS), long (LS), extreme-long (ELS), ots (OTS), pov (POV), insert. Other text is kept as free text. | |
| actionText | No | What the frame shows and what happens in it, as a concrete visual description for the storyboard image. To show a Story element (character, place, object) write its referenceHandle from list_entities, e.g. @ref_storyboard_char_alice_sheet for the character Alice. The server turns known handles into live references (they read back as @#<entityId>-story-element); unknown ones stay as plain text. Read-back @# tokens can be sent again unchanged. | |
| cameraMovement | No | Camera movement. A preset value or label: static, pan-left, pan-right, tilt-up, tilt-down, dolly-in, dolly-out, truck-left, truck-right, pedestal-up, pedestal-down, crane, handheld, steadicam, whip-pan, zoom-in, zoom-out. Other text is kept as free text. | |
| durationSeconds | No | Shot length in seconds (0.5 to 3600, rounded to a tenth). | |
| continuesFromShotId | No | Link this shot as a continuation of an earlier shot of the same scene (shotId), or null to unlink it. The shot must come after its predecessor in the timeline. |