# Operations with Specific LocaleSettings

This resource lets you work with the system language settings of your YouTrack service.
|  Resource  |     ```GENERIC /api/admin/globalSettings/localeSettings ```    |
| --- | --- |
|  Returned entity  |  [LocaleSettings](api-entity-LocaleSettings.html). For the description of the entity attributes, see [Supported Fields](#LocaleSettings-supported-fields) section.  |
|  Supported methods  |      * `GET`: [Read a Specific LocaleSettings](#get-LocaleSettings-method).    * `POST`: [Update a Specific LocaleSettings](#update-LocaleSettings-method).    |

## LocaleSettings attributes

Represents the System Language settings.

### Related Resources

Below you can find the list of resources that let you work with this entity.

* [Locale Settings](resource-api-admin-globalSettings-localeSettings.html)

### Attributes

This table describes attributes of the `LocaleSettings` entity.

* To receive an attribute in the response from the server, specify it explicitly in the `fields` request parameter.

* To update an attribute, provide it in the body of a POST request.

|  Field  |  Type  |  Description  |
| --- | --- | --- |
|  id  |  String  |  The ID of the LocaleSettings. `Read-only`.  |
|  locale  |  [LocaleDescriptor](api-entity-LocaleDescriptor.html)  |  Current locale of YouTrack.  |
|  isRTL  |  Boolean  |  Indicates whether the current system language is right-to-left.  |

## Read a Specific LocaleSettings

Read the current system language of your YouTrack service.

### Request syntax

```GENERIC
GET /api/admin/globalSettings/localeSettings?{fields}
```

|  null  |  The database ID of LocaleSettings  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of LocaleSettings attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.  |

### Sample

#### Sample request

```CURL
https://example.youtrack.cloud/api/admin/globalSettings/localeSettings?fields=locale(name,community,locale,language),isRTL
```

#### Sample response body

```JSON
{
  "locale": {
    "name": "English",
    "locale": "en_US",
    "community": false,
    "id": "en_US",
    "language": "en",
    "$type": "LocaleDescriptor"
  },
  "isRTL": false,
  "$type": "LocaleSettings"
}
```

## Update a Specific LocaleSettings

Change the system language of your YouTrack service.

Required parameters: Database `id` of the target locale. It usually has the same value as the `locale` attribute.

### Required permissions

Requires permissions: Low-level Admin Write

### Request syntax

```GENERIC
POST /api/admin/globalSettings/localeSettings?{fields}
```

|  null  |  The database ID of LocaleSettings  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of LocaleSettings attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.  |

### Sample

#### Sample request

```CURL
https://example.youtrack.cloud/api/admin/globalSettings/localeSettings?fields=locale(id,name,community,locale,language),isRTL
```

#### Sample request body

```JSON
{
  "locale": {
    "id": "de_DE"
  }
}
```

#### Sample response body

```JSON
{
  "locale": {
    "name": "Deutsch",
    "locale": "de_DE",
    "community": false,
    "id": "de_DE",
    "language": "de",
    "$type": "LocaleDescriptor"
  },
  "isRTL": false,
  "$type": "LocaleSettings"
}
```