---
title: "PUT /settings - Settings · RUAL Documentation"
description: "PUT: Update an existing system setting"
canonical: https://docs.rual.nl/cluster/api/settings/settings-put
language: en
---

# PUT /settings

Update an existing system setting

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

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **description** optional | `string` | `"Used by the nightly order sync."` |  |
| **is_secure** optional | `boolean` | `true` |  |
| **label** required | `string` | `"Database host"` |  |
| **value** required | `string` | `"enabled"` |  |

```
{
  "description": "Used by the nightly order sync.",
  "is_secure": true,
  "label": "Database host",
  "value": "enabled"
}
```

```
{
  "code": 401,
  "error": "INVALID_ACCESS_TOKEN"
}
```

| Status | Error Code | Description |
| --- | --- | --- |
| `401` | `INVALID_ACCESS_TOKEN` | Authentication required or invalid token |
| `403` | `INSUFFICIENT_PERMISSIONS` | Insufficient permissions for this operation |

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