> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contence.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Version notes

> What a version was asked for, the model that made it, a timed change list and the comments it fixes.

Every version of a project video can carry notes:

* **Asked for**: the exact words of the person who asked for this version, such as "make the intro punchier".
* **Made with**: the model or editor that made it, such as `claude-opus-5-5`.
* **What changed**: a timed list of changes, each on one track.
* **Fixes**: the review comments on earlier versions that this version fixes.

The notes show at the top of the version page, and the change list is drawn on the player's timeline.

## The change list

Each change is one line: an optional timecode or range, a track, and what changed.

```text theme={null}
0:04-0:09 video: swapped the b-roll
1:02 captions: fixed the typo
music: new bed under the whole cut
```

A line with no timecode applies to the whole video. The tracks are `video`, `text`, `graphics`, `captions`, `voice`, `music`, `sfx`, `color` and `other`.

## Fixing comments in one loop

When an agent starts uploading a second or later version, Contence returns every review comment still open on the earlier versions, with its number, timecode, author and text. The agent sees what to fix without asking.

The agent then uploads the new version with its notes and the comments it fixes:

```bash theme={null}
contence upload cut-v2.mp4 --project PROJECT_ID \
  --prompt "make the logo bigger and duck the music" \
  --model claude-opus-5-5 \
  --change "0:01-0:03 graphics: logo 40% larger" \
  --change "0:06-0:10 music: ducked 6 dB" \
  --resolves 1,2
```

A comment to fix is its number on the previous version or its comment id. When the upload finishes, each of those comments closes as fixed in the new version, and the reply lists the comments still open for the next pass. A comment that is not on an earlier version of the same video is refused before anything uploads.

## Changing notes later

Notes can be added or changed after the upload. In the app, approvers and admins can edit any version's notes, and an editor can edit notes on their own upload. An agent can change notes on a version it uploaded:

```bash theme={null}
contence notes FILE_ID --prompt "..." --resolves 3
```

Only the fields sent change.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.