# archive\_agents

Archive agents, stopping each and keeping its record and transcript for `restore_agents`.

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

Komrad refuses a task's writer, which is archived only with its task through [`archive_task`](https://komrad.dev/latest/api/task/archive-task.md).

## Calling it

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

```bash
komrad rpc archive-agents \
  --ids '<uuid>'
```

```json
{
  "name": "archive_agents",
  "arguments": {
    "ids": [
      "<ids>"
    ]
  }
}
```

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

## Request

### ArchiveAgentsRequest

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

## Response

### Empty

No fields.
