JsonCutDocs

Exporting, versions and project history

Preview the current edit, save immutable versions and export a pinned image or video result.

Save and version

Every successful source replacement creates a new numeric project version. API and Agent edits include the version they inspected; if someone else saved first, the write returns a conflict instead of overwriting newer work.

This is optimistic concurrency: read the latest project, reapply the intended bounded change, then save against the new version.

Version history

The clock icon in the editor's top bar opens the version history: the 20 newest saved versions of the project, each with its name, time and who made it (Studio, AI Director or API).

  • Save version keeps the current state under a name.
  • The AI Director saves the state before each run (“Before AI Director: …”, in images “Before AI Designer: …”), and the first change over an API key or MCP after work in Studio saves the state before it (“Before API changes”).
  • Restore copies a saved version back as the new current version. The state you leave is saved first as “Before restore”, so a restore can be undone too, and the AI Director is told that earlier changes are gone.
  • Rename versions, or select several and delete them. When a 21st version is saved, the oldest one leaves the history.

Saving a version copies nothing: it keeps one of the project's recent checkpoints from expiring.

Preview and export

Use preview for creative review and export for the final artifact. A video should be watched across transitions and audio boundaries; a still should be checked at its actual output aspect ratio and, when relevant, against transparent surroundings.

The public V2 output contract supports still images as PNG, JPEG/JPG, WebP and PDF, plus the video, audio and handoff format and codec combinations listed by the live OpenAPI reference. Availability can depend on the requested output kind.

The video export dialog has three outputs:

  • Video: MP4, WebM, MOV or GIF. Resolution offers the original size, 4K, Full HD, HD and SD; Codec H.264 or H.265 (HEVC) for MP4, VP9 for WebM, H.264 or ProRes for MOV; Frame rate 12 to 60 fps (GIF up to 20 fps and without sound); Quality Fast or High; Audio on or off. Length exports the whole video or a range (In and Out in seconds, or set from the playhead). Loudness keeps the project's master or sets web and social (−14 LUFS) or broadcast (−23 LUFS). Transparent background appears for MOV with ProRes (exported as ProRes 4444) and WebM with VP9: only the layers, no canvas colour. It is off by default because it renders slower and the files are much larger.
  • Audio only: the mixed sound as WAV (24-bit), MP3, M4A (AAC) or Opus, with the same length and loudness options. No frames are rendered.
  • Handoff: a ZIP for Final Cut Pro, Premiere Pro and DaVinci Resolve. It holds project.fcpxml and project.xml (Premiere XML), the media files in media/, captions as captions.srt (when the project has captions), REPORT.md and README.txt, which says how to import the timeline in each program. Footage, images and sound that play untransformed over the whole canvas arrive as editable clips with their in and out points. Text, graphics and transformed or keyed footage come along only with Graphics overlay switched on: they are rendered as one transparent ProRes 4444 video on the top track. The report lists which layer went which way. A handoff holds at most 4 GB of files.

The image export dialog offers PNG, WebP, JPG, JPEG and PDF, a file name, the output size (Original, 2× or 1080px wide, with the ratio locked or free) and a quality slider for every format except PNG. Transparent background works with PNG and WebP. Carousels export All pages (one image per page in a ZIP), One page or As one image; a PDF always holds every page.

Downloads are available for 24 hours. Share via link creates a link for 1 hour or 1 day, at most until the export expires. Your project stays editable.

Project files and timelines from editing programs

A .jsoncut project file holds the saved project with every media file it uses, checked with SHA-256. Save one with the download icon on a project card in Projects, or with Download .jsoncut under Project file in the export dialog. Import in Projects, or Import project on the workspace home, opens it again as a new project, in this or another workspace; files the workspace already has are reused instead of stored twice. Project files can hold long videos (up to 4 GB in total). Over the API the same file comes from GET /api/v2/projects/{id}/bundle and goes back in with POST /api/v2/projects/import (see the V2 API reference).

Import also reads a timeline from an editing program: FCPXML (Final Cut Pro, DaVinci Resolve), Premiere XML or a CMX 3600 EDL (with its frame rate chosen on import). The dialog lists the files the timeline uses; add them and they are matched by file name. Clips are placed with their source in points, stacking and sound. Titles, effects and transitions stay in the editing program and are listed; clips whose file is missing are left out.

Render lifecycle

Exports are asynchronous:

  1. queued
  2. rendering
  3. completed, failed or cancelled

The finished render resource contains safe artifact metadata and a temporary download URL. Server integrations can use the authenticated artifact route or signed webhooks.

See Rendering, operations and outputs for code examples.