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

# Restore Revision

> Restore an old manual revision as a new head revision — history is never rewritten.

Restores a historical snapshot by applying it as a **new** head revision — restore is itself a changeset, so history stays append-only and auditable. Honors the `Idempotency-Key` header.

**Requirements:** `instructions:write` + workspace `EDITOR` or `OWNER` + a verified (claimed) account.

## Request

<ParamField path="manualId" type="string" required>
  The manual id.
</ParamField>

<ParamField path="revisionNumber" type="number" required>
  The historical revision to restore.
</ParamField>

## Response

<ResponseField name="applied" type="boolean">
  Whether the restore committed.
</ResponseField>

<ResponseField name="changesetId" type="string | null">
  The changeset that performed the restore.
</ResponseField>

<ResponseField name="restoredFromRevisionNumber" type="number">
  The source revision.
</ResponseField>

<ResponseField name="manualRevisions" type="object[]">
  The new head revision.
</ResponseField>

<ResponseField name="pageRevisions" type="object[]">
  New per-page revisions with checksums.
</ResponseField>

<ResponseField name="conflicts" type="object[]">
  Structured conflicts when the restore could not apply.
</ResponseField>