# delete\_documents

Delete documents and every earlier version of each.

writes · idempotent · destructive · CLI only · [Agent](https://komrad.dev/latest/api/agent.md)

Any unknown id fails the call, and nothing is deleted.

## Calling it

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

```bash
komrad rpc delete-documents \
  --ids '<uuid>'
```

## Request

### DeleteDocumentsRequest

| Field | Type | Description |
| --- | --- | --- |
| [`ids`](https://komrad.dev/latest/api/agent/delete-documents.md#komrad-agent-v1-DeleteDocumentsRequest-ids) | uuid\[\]\* no repeats | The documents to delete, by id. |

## Response

### Empty

No fields.
