Editing
Read clip editor state
Inspect draft settings, timing clocks and stored render inputs before updating a clip through the API.
- 1
Read the editor-state endpoint to inspect draft settings, saved render inputs and workspace edit permissions. Each editing action still checks its own plan and readiness requirements.
- 2
Cuts, word corrections, hidden captions, transitions, emoji and scene layouts use absolute source seconds. Text and image overlays use time from the clip's beginning before cuts. B-roll, sound effects and caption-safe windows use the rendered clip clock.
- 3
Transition diagnostics distinguish the source seam from its compacted position before transition overlap. Use the returned timing map for each field.
- 4
Read arrays are snapshots. Send the editor route's operation objects to update them; older snapshots can omit individual fields.
- 5
The render revision is a cache and render marker. A later applied write can replace an earlier draft change, without a conditional draft-write guarantee.
- 6
Persisted render-stage inputs can be partial. They do not certify that every layer belongs to the same successful final export.
- 7
Image and B-roll keys are authorized asset handles rather than public download links. Sound-effect file keys are excluded from the snapshot.
- 8
The active hook overlay supplies its text. An explicitly empty overlay list means the hook was removed, even when an older hook field remains.