> ## 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.

# Diff Revisions

> Compare two manual revisions page by page.

Compares two manual revisions and summarizes what changed per page.

**Requirements:** `instructions:read`.

## Request

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

<ParamField query="a" type="number" required>
  Base revision number.
</ParamField>

<ParamField query="b" type="number" required>
  Target revision number.
</ParamField>

## Response

<ResponseField name="manualId" type="string">
  Echo of the manual.
</ResponseField>

<ResponseField name="a" type="number">
  Base revision.
</ResponseField>

<ResponseField name="b" type="number">
  Target revision.
</ResponseField>

<ResponseField name="pages" type="object[]">
  Per-page diff summaries: `{pageId, title, kind, insertedNodes, deletedNodes, replacedNodes, nodeIds}`.
</ResponseField>