---
title: "PUT /users/{guid} - Users · RUAL Documentation"
description: "Update a specific user"
canonical: https://docs.rual.nl/cluster/api/users/users--guid-put
language: en
---

# PUT /users/{guid}

Update a specific user

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **guid** required | `string` | `"example"` | Unique identifier (GUID) |

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

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **active** optional | `boolean` | `true` | Whether user is active |
| **email** optional | `string` | `"joe@example.com"` | Email address |
| **first_name** optional | `string` | `"joe doe"` | First name |
| **language** optional | `string` | `"en"` | User language |
| **last_name** optional | `string` | `"joe doe"` | Last name |
| **timezone** optional | `string` | `"Europe/Amsterdam"` | User timezone |

```
{
  "_meta": {
    "created": 1782166695,
    "entity": 1,
    "guid": "a23575f49d0af385314c1f02280163374297e018a692e5e4ab85eb307ebf6ebc",
    "modified": 1782166695,
    "updated": 1782166695
  },
  "email": "joe@example.com",
  "firstname": "Joe",
  "language": "en",
  "last_activity": 1782166695,
  "lastname": "Doe",
  "timezone": "Europe/Amsterdam",
  "username": "joe"
}
```

```
{
  "error": "ERROR_KEY"
}
```

| Permission | Description |
| --- | --- |
| `Bearer token` | Access token required via Authorization header, x-authtoken, x-token, query param, or cookie |
| `users_remove` | Required scope: users_remove |
| `setting_manage_users` | Additional permission check: setting_manage_users |