# Operations with Specific GeneralUserProfile

This resource lets you read and update general settings in the YouTrack profile of the specified user.
|  Resource  |     ```GENERIC /api/users/{userID}/profiles/general ```    |
| --- | --- |
|  Returned entity  |  [GeneralUserProfile](api-entity-GeneralUserProfile.html). For the description of the entity attributes, see [Supported Fields](#GeneralUserProfile-supported-fields) section.  |
|  Supported methods  |      * `GET`: [Read a Specific GeneralUserProfile](#get-GeneralUserProfile-method).    * `POST`: [Update a Specific GeneralUserProfile](#update-GeneralUserProfile-method).    |

## GeneralUserProfile attributes

Represents the user profile in YouTrack.

### Related Resources

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

* [General User Profile](resource-api-users-userID-profiles-general.html)

### Attributes

This table describes attributes of the `GeneralUserProfile` 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 user profile. `Read-only`.  |
|  dateFieldFormat  |  [DateFormatDescriptor](api-entity-DateFormatDescriptor.html)  |  Format in which dates are shown to this user.  |
|  timezone  |  [TimeZoneDescriptor](api-entity-TimeZoneDescriptor.html)  |  Timezone of the user.  |
|  locale  |  [LocaleDescriptor](api-entity-LocaleDescriptor.html)  |  Personal locale selected by the user.  |

## Read a Specific GeneralUserProfile

Get profile with general settings of the user's profile.

### Required permissions

Requires Read Self to read own profile and Read User Full to read profile of another user.

### Request syntax

```GENERIC
GET /api/users/{userID}/profiles/general?{fields}
```

|  null  |  The database ID of GeneralUserProfile  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of GeneralUserProfile 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/users/1-2/profiles/general?fields=id,dateFieldFormat(id,presentation,pattern,datePattern),timezone(id,presentation,offset),locale(id,name,community,language,locale)
```

#### Sample response body

```JSON
{
  "locale": {
    "name": "English",
    "locale": "en_US",
    "community": false,
    "id": "en_US",
    "language": "en",
    "$type": "LocaleDescriptor"
  },
  "timezone": {
    "presentation": "Central European Summer Time (UTC/GMT +2 hours)",
    "id": "Europe/Berlin",
    "offset": 120,
    "$type": "TimeZoneDescriptor"
  },
  "dateFieldFormat": {
    "pattern": "d MMM yyyy HH:mm",
    "presentation": "Default date format (31 Dec 2000 23:59)",
    "datePattern": "d MMM yyyy",
    "id": "",
    "$type": "DateFormatDescriptor"
  },
  "id": "generalProfile",
  "$type": "GeneralUserProfile"
}
```

## Update a Specific GeneralUserProfile

Change settings in the specific user profile.

### Required permissions

Requires Update Self to update own profile and Update User to update profile of another user.

### Request syntax

```GENERIC
POST /api/users/{userID}/profiles/general?{fields}
```

|  null  |  The database ID of GeneralUserProfile  |
| --- | --- |

### Request parameters

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

### Sample

Let's change the time zone for the specific user.

#### Sample request

```CURL
https://example.youtrack.cloud/api/users/1-2/profiles/general?fields=id,timezone(id,presentation,offset)
```

#### Sample request body

```JSON
{
  "timezone": {
    "id": "Europe/Moscow"
  }
}
```

#### Sample response body

```JSON
{
  "timezone": {
    "presentation": "Moscow Standard Time (UTC/GMT +3 hours)",
    "id": "Europe/Moscow",
    "offset": 180,
    "$type": "TimeZoneDescriptor"
  },
  "id": "generalProfile",
  "$type": "GeneralUserProfile"
}
```

