REST API · v1
Read editor state
Inspect a clip before staging edits. The response separates current draft choices, persisted render-stage inputs and frame geometry. Workspace edit permission still depends on each action's plan and readiness checks. Read arrays describe saved values; updates use route-specific operation objects. Older rows can omit individual fields. Persisted render inputs can be partial and do not certify an atomic snapshot of every layer in the last successful finished export.
https://polished-turtle-977.convex.siteGet an API keyGET
/api/v1/clips/{id}/editor
Read the source window, draft captions and overlays, timing map, layout, audio settings and stored render inputs. This read does not spend credits or start a render.
- Response shape
- { clipId, snapshotSchemaVersion: 1, status: string|null, canEdit: boolean, renderRevision: number, concurrency: { mode: "last_write_wins", conditionalWrites: false }, sourceWindow: { startSec: number|null, endSec: number|null }, timebases: { cuts: "source", wordEdits: "source", captionRemovedRanges: "source", transitions: "source", emojiMoments: "source", layoutOverrides: "source", sceneCuts: "source", textOverlays: "clip_before_cuts", imageOverlays: "clip_before_cuts", brollPlacements: "rendered_clip", sfxPlacements: "rendered_clip", captionSafeWindows: "rendered_clip" }, draft: { cutRanges[], wordEdits[], captionRemovedRanges[], captionStyle|null, textOverlays[], imageOverlays[], transitions, emojiMoments[], emojiEnabled|null, crop, effectFlags, audioVolume, tracker, hookText|null, speakerColors, audioEnhance, autoCensor, censorAudioMode, layout, broll, audio }, rendered: { cutRanges[], wordEdits[], captionRemovedRanges[], textOverlays[], imageOverlays[], sfxPlacements[], transitions, transitionSeams[], crop }, geometry: { sourceWidth|null, sourceHeight|null, captionSafeTopPct|null, captionSafeBottomPct|null, captionSafeWindows[], sceneCutsSec[] } }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/clips/{id}/editor' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY"