Skip to main content
POST
Create one immutable content-addressed review version. The version is addressable by its rvr_… id and forms the parent of any subsequent correction in the version graph. Versions live in their own collection, addressable via flat CRUD — review_id lives in the body, not the URL.

Idempotency

Version ids are sha256(canonical_json(normalized_snapshot)). Submitting the same (review_id, parent_id, snapshot) triple returns the existing row; the server does not create a duplicate. Submitting the same content with a different parent_id returns 409 parent_conflict.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a corrected version of a review.

parent_id must reference an existing version under the same review_id.

review_id
string
required
Minimum string length: 1
parent_id
string
required
Pattern: ^rvr_[A-Z2-7]{26}$
snapshot
Snapshot · object
required

The full reviewed snapshot to store as an immutable version. The object must match the gated block type: extract uses the raw output object; classifier uses {'category': string}; split uses {'documents': [{'name': string, 'pages': positive sorted int[]}]}; for_each uses {'partitions': [{'key': string, 'pages': positive sorted int[]}]}. The server validates the shape and stores the exact submitted object when valid.

note
string | null
acknowledged_superseded_version_ids
string[]

Version ids the caller has seen and is deliberately superseding. A review's versions form a lineage; deciding (or parenting on) a version that is not its only latest version discards every other latest version, so the server refuses that write with a 409 unless every discarded id is listed here. Leave empty unless you are intentionally rolling back to an earlier version or choosing one arm of a forked lineage. The 409 detail names the exact ids to pass.

Response

Successful Response

Public API shape for one immutable review version.

id
string
required
Pattern: ^rvr_[A-Z2-7]{26}$
review_id
string
required
author
Actor · object
required

Actor that created the version.

snapshot
Snapshot · object
required
created_at
string<date-time>
required

When the review version was created.

parent_id
string | null
Pattern: ^rvr_[A-Z2-7]{26}$
note
string | null