# delete\_mail

Delete mail for good by id, read or not.

writes · idempotent · destructive · MCP tool · [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/DeleteMail \
  -H 'Content-Type: application/json' \
  -d '{
  "ids": [
    "<ids>"
  ]
}'
```

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

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

Offered by the komrad MCP server to orchestrator agents.

## Request

### DeleteMailRequest

| Field | Type | Description |
| --- | --- | --- |
| [`ids`](https://komrad.dev/latest/api/agent/delete-mail.md#komrad-agent-v1-DeleteMailRequest-ids) | uuid\[\]\* | The mail to delete, by id, read or not. The recipient never sees unread mail once deleted. |

## Response

### Empty

No fields.
