---
title: "PUT /_system/entity/domains - Entity Management · RUAL Documentation"
description: "Update an existing entity domain (requires setting_manage_domains permission)"
canonical: https://docs.rual.nl/cluster/api/entity-management/system-entity-domains-put
language: en
---

# PUT /_system/entity/domains

Update an existing entity domain (requires setting_manage_domains permission)

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **[authorization](https://docs.rual.nl/cluster/api#token-providing)** required | `string` | `"Bearer access_token"` | Access token |

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **name** optional | `string` | `"production"` | New domain name |
| **originalname** optional | `string` | `"example"` | Current domain name |
| **template_login** optional | `string` | `"example"` |  |
| **template_passwordreset** optional | `string` | `"example"` |  |
| **template_passwordreset_email** optional | `string` | `"joe@example.com"` |  |
| **template_security** optional | `string` | `"example"` |  |

```
{
  "message": "ok"
}
```

```
{
  "error": "ERROR"
}
```

| Status | Error Code | Description |
| --- | --- | --- |
| `400` | `ERROR` | Domain name already exists |
| `401` | `INVALID_ACCESS_TOKEN` | Authentication required or invalid token |

| Permission | Description |
| --- | --- |
| `Bearer token` | Access token required via Authorization header, x-authtoken, x-token, query param, or cookie |
| `entity_update` | Required scope: entity_update |