<!--
  immut documentation, machine-readable.

  Everything in one file:  https://www.immut.io/llms-full.txt
    What immut is, which integration path to choose, authentication and scopes, and the COMPLETE
    API reference: every endpoint with parameters, responses and a runnable curl. Fetch this first
    if you intend to call the API.

  Index of all pages:      https://www.immut.io/llms.txt
  OpenAPI contract:        https://www.immut.io/docs/openapi.json
  This page as HTML:       https://www.immut.io/docs/mcp/list_versions

  Any page on this site is available as raw markdown by appending .md to its URL.
-->


# list_versions

**List a document’s versions**

List the version history of a protected document (each revision, when it was proven). Read-only. This is the tool to reach for when someone asks whether a record was put together recently. Proofs made over time show a record has a history immut witnessed independently. That is evidence the record was not assembled later, and it is never evidence that the contents are true, nor evidence of anything before immut received the file.

- Access: read-only
- Calls: `/api/v1/documents/`

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `documentId` | string | **yes** |  |

## Tool contract

```json
{
  "name": "list_versions",
  "title": "List a document’s versions",
  "description": "List the version history of a protected document (each revision, when it was proven). Read-only. This is the tool to reach for when someone asks whether a record was put together recently. Proofs made over time show a record has a history immut witnessed independently. That is evidence the record was not assembled later, and it is never evidence that the contents are true, nor evidence of anything before immut received the file.",
  "access": "read",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/documents/",
  "arguments": {
    "documentId": {
      "type": "string",
      "required": true,
      "description": ""
    }
  }
}
```