Operations with Specific AppearanceSettings

This resource lets you work with the Visual settings of your YouTrack service.

Resource	/api/admin/globalSettings/appearanceSettings
Returned entity	AppearanceSettings. For the description of the entity attributes, see Supported Fields section.
Supported methods	`GET`: Read a Specific AppearanceSettings. `POST`: Update a Specific AppearanceSettings.

AppearanceSettings attributes

Represents the Visual settings of the YouTrack service.

This table describes attributes of the AppearanceSettings entity.

To receive an attribute in the response from server, specify it explicitly in the request parameter fields.
To update an attribute, provide it in the body of a POST request.

Field	Type	Description
timeZone	TimeZoneDescriptor	Default application time zone
dateFieldFormat	DateFormatDescriptor	Default format for dates presentation.
logo	Logo	Application logo. `Read-only`.

Read a Specific AppearanceSettings

Read the Visual settings of your YouTrack service.

Request syntax

GET /api/admin/globalSettings/appearanceSettings?{fields}

Request parameters

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

Sample

Sample request

curl -L -X GET 'https://example.myjetbrains.com/youtrack/api/admin/globalSettings/appearanceSettings?fields=dateFieldFormat(datePattern,pattern,presentation),timeZone(id,presentation,offset)' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer perm:am9obi5kb2U=.UG9zdG1hbiBKb2huIERvZQ==.jJe0eYhhkV271j1lCpfknNYOEakNk7'
            

Sample response body

{
  "timeZone": {
    "presentation": "Central European Summer Time (UTC/GMT +2 hours)",
    "id": "Europe/Berlin",
    "offset": 180,
    "$type": "TimeZoneDescriptor"
  },
  "dateFieldFormat": {
    "pattern": "d MMM yyyy HH:mm",
    "presentation": "Default date format (31 Dec 2000 23:59)",
    "datePattern": "d MMM yyyy",
    "$type": "DateFormatDescriptor"
  },
  "$type": "AppearanceSettings"
}
            

Update a Specific AppearanceSettings

Change the Visual settings of your YouTrack service.

Required permissions

Requires Low-level Admin Write permission.

Request syntax

POST /api/admin/globalSettings/appearanceSettings?{fields}

Request parameters

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

Sample

Sample request

curl -L -X POST 'https://example.myjetbrains.com/youtrack/api/admin/globalSettings/appearanceSettings?fields=dateFieldFormat(id,presentation),timeZone(id,presentation)' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer perm:am9obi5kb2U=.UG9zdG1hbiBKb2huIERvZQ==.jJe0eYhhkV271j1lCpfknNYOEakNk7' \
--data-raw '{
	"timeZone": {
      "id": "Europe/Berlin"
      }
}'
            

Sample request body

{
  "timeZone": {
    "id": "Europe/Berlin"
  }
}
            

Sample response body

{
  "timeZone": {
    "presentation": "Central European Summer Time (UTC/GMT +2 hours)",
    "id": "Europe/Berlin",
    "$type": "TimeZoneDescriptor"
  },
  "dateFieldFormat": {
    "presentation": "Default date format (31 Dec 2000 23:59)",
    "id": "",
    "$type": "DateFormatDescriptor"
  },
  "$type": "AppearanceSettings"
}
            

Last modified: 30 March 2021