# rename\_agent

Rename an agent by id.

writes · 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/UpdateAgent \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "<id>",
  "name": "<name>"
}'
```

```bash
komrad rpc rename-agent \
  --id '<uuid>' \
  --name '<string>'
```

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

Offered by the komrad MCP server to orchestrator agents.

## Request

### UpdateAgentRequest

| Field | Type | Description |
| --- | --- | --- |
| [`id`](https://komrad.dev/latest/api/agent/rename-agent.md#komrad-agent-v1-UpdateAgentRequest-id) | uuid\* | The agent to rename, by id. |
| [`name`](https://komrad.dev/latest/api/agent/rename-agent.md#komrad-agent-v1-UpdateAgentRequest-name) | string\* at most 200 characters name must not contain spaces, colons, dots, or slashes must not contain control characters | The agent's new name. |

## Response

### Empty

No fields.
