# list\_document\_type\_versions

List every write of a document type, newest first.

read-only · idempotent · MCP tool · [Agent](https://komrad.dev/latest/api/agent.md)

## Calling it

```bash
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/ListDocumentTypeVersions \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "<id>"
}'
```

```bash
komrad rpc list-document-type-versions \
  --id '<uuid>'
```

```json
{
  "name": "list_document_type_versions",
  "arguments": {
    "id": "<id>"
  }
}
```

Offered by the komrad MCP server to writer, reviewer, orchestrator agents.

## Request

### ListDocumentTypeVersionsRequest

| Field | Type | Description |
| --- | --- | --- |
| [`id`](https://komrad.dev/latest/api/agent/list-document-type-versions.md#komrad-agent-v1-ListDocumentTypeVersionsRequest-id) | uuid\* | The document type whose versions to list, by id. |

## Response

### ListDocumentTypeVersionsResponse

| Field | Type | Description |
| --- | --- | --- |
| [`versions`](https://komrad.dev/latest/api/agent/list-document-type-versions.md#komrad-agent-v1-ListDocumentTypeVersionsResponse-versions) | [DocumentTypeVersion\[\]](https://komrad.dev/latest/api/agent/list-document-type-versions.md#komrad-agent-v1-DocumentTypeVersion) | Every version of the document type, newest first. |

## Types

### DocumentTypeVersion

DocumentTypeVersion is one write of a document type, without its context.

| Field | Type | Description |
| --- | --- | --- |
| [`version`](https://komrad.dev/latest/api/agent/list-document-type-versions.md#komrad-agent-v1-DocumentTypeVersion-version) | int32 | The version's number, to pass to [`get_document_type`](https://komrad.dev/latest/api/agent/get-document-type.md). |
| [`name`](https://komrad.dev/latest/api/agent/list-document-type-versions.md#komrad-agent-v1-DocumentTypeVersion-name) | string | The document type's name at this version. |
| [`created_at`](https://komrad.dev/latest/api/agent/list-document-type-versions.md#komrad-agent-v1-DocumentTypeVersion-created_at) | timestamp | When this version was written. |
