Restore an archived document version

POST 
/v1/projects/:project_id/documents/:document_id/versions/:version/restore

Writes an archived version's content and annotations back as the document's live state, which archives them again as a new version rather than rewinding the counter — so a run citing any version in between still resolves.

The restore runs through the ordinary update path, so the content is re-chunked and re-embedded; restoring the state the document already holds is a no-op and archives nothing. Restoring any content version of a withdrawn document brings it back into listings and search.

A tombstone version has no content, so naming one is 400 VALIDATION_FAILED: restore the version before it instead.

Request

Responses

200

The document, at its new version

400

Bad Request — invalid version, or the version is a withdrawal

401

Unauthorized

403

Forbidden

404

Document or version not found

409

Another write took the document's version first (VERSION_CONFLICT, with meta.current_version), or the restored path is held by another file in the project (NAME_CONFLICT). Nothing is written.