# get\_document

Read one document in full, or an earlier version of it.

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/GetDocument \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "<id>"
}'
```

```bash
komrad rpc get-document \
  --id '<uuid>'
```

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

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

## Request

### GetDocumentRequest

| Field | Type | Description |
| --- | --- | --- |
| [`id`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-GetDocumentRequest-id) | uuid\* | The document to read, by id. |
| [`version`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-GetDocumentRequest-version) | int32 more than 0 | The version to read. Unset reads the newest. |

## Response

### GetDocumentResponse

| Field | Type | Description |
| --- | --- | --- |
| [`document`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-GetDocumentResponse-document) | [Document](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-Document) | The document, with its text. |

## Types

### Document

Document is markdown an agent writes for the person to read.

| Field | Type | Description |
| --- | --- | --- |
| [`id`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-Document-id) | uuid\* | The document's id. |
| [`agent_id`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-Document-agent_id) | uuid\* | The id of the agent that owns the document. |
| [`name`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-Document-name) | string | The document's title. No two of one agent's documents share one. |
| [`type`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-Document-type) | string | The name of the document's type. |
| [`body`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-Document-body) | string | The document's text, in markdown. Empty in a listing. |
| [`created_at`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-Document-created_at) | timestamp | When the document was created. |
| [`updated_at`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-Document-updated_at) | timestamp | When the document was last written. |
| [`version`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-Document-version) | int32 | How many times the document has been written. |
| [`task_id`](https://komrad.dev/latest/api/agent/get-document.md#komrad-agent-v1-Document-task_id) | uuid | The id of the task the agent was on when the document was created. Unset for an orchestrator's documents. |
