# Update tenant settings

URL: /en/docs/api/v1/settings/patch
Last Updated: 2026-07-30T21:15:44.963Z

## Description
No description available.

## Available Actions
- Execute PATCH request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### PATCH /api/v1/settings

**Update tenant settings**

Partially update tenant settings. When `languages_enabled` is supplied, the API removes the tenant default locale from the stored additional-language list.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Request body** (`application/json`) - required:

- `ai_enabled` (boolean)
- `subscription_enabled` (boolean)
- `trusted_by_auto_scroll_enabled` (boolean)
- `timezone` (string)
- `languages_enabled` (array of enum: en | de | fr | ja | ko | zh): Additional content locales to enable.

Example (Enable German content):

```json
{
  "languages_enabled": [
    "de"
  ]
}
```

**Responses:**

- `200` - Tenant settings updated
  - `success` (boolean, required)
  - `data` (Settings (object), required)
    - `ai_enabled` (boolean, required)
    - `subscription_enabled` (boolean, required)
    - `trusted_by_auto_scroll_enabled` (boolean, required)
    - `timezone` (string, required)
    - `locale` (enum: en | de | fr | ja | ko | zh, required): Tenant default content locale.
    - `languages_enabled` (array of enum: en | de | fr | ja | ko | zh, required): Additional enabled content locales. The default locale is not included.
- `400` - Validation error
- `401` - Unauthorized
- `403` - Forbidden - Admin role required
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X PATCH "https://app.orbiqhq.com/api/v1/settings" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "languages_enabled": ["de"]
  }'
```

