# Operations with Specific SystemSettings

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

## SystemSettings attributes

Represents the System settings that affect core functionality of YouTrack.

### Related Resources

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

* [System Settings](resource-api-admin-globalSettings-systemSettings.html)

### Attributes

This table describes attributes of the `SystemSettings` 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 SystemSettings. `Read-only`.  |
|  baseUrl  |  String  |  Base URL of the YouTrack installation. `Can be null`.  |
|  maxUploadFileSize  |  Long  |  Maximum size of the file that can be uploaded.  |
|  maxExportItems  |  Int  |  Maximum number of issues that can be exported.  |
|  administratorEmail  |  String  |  Email of server administrator. `Can be null`.  |
|  allowStatisticsCollection  |  Boolean  |  Indicates whether it is allowed to collect usage statistics.  |
|  isApplicationReadOnly  |  Boolean  |  `true`, if the application is currently in the read-only mode. Otherwise, `false`.  |

## Read a Specific SystemSettings

Read the System settings of your YouTrack service.

### Required permissions

Requires permissions: Low-level Admin Read

### Request syntax

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

|  null  |  The database ID of SystemSettings  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of SystemSettings 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/systemSettings?fields=baseUrl,maxUploadFileSize,maxExportItems,allowStatisticsCollection,isApplicationReadOnly
```

#### Sample response body

```JSON
{
  "maxUploadFileSize": 10485760,
  "isApplicationReadOnly": false,
  "maxExportItems": 500,
  "allowStatisticsCollection": true,
  "baseUrl": "https://example.youtrack.cloud",
  "$type": "SystemSettings"
}
```

## Update a Specific SystemSettings

Change the System settings of your YouTrack service.

### Required permissions

Requires permissions: Low-level Admin Write

### Request syntax

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

|  null  |  The database ID of SystemSettings  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of SystemSettings 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/systemSettings?fields=baseUrl,maxUploadFileSize,maxExportItems,allowStatisticsCollection,isApplicationReadOnly
```

#### Sample request body

```JSON
{
  "maxUploadFileSize": 20971520,
  "maxExportItems": 250
}
```

#### Sample response body

```JSON
{
  "maxUploadFileSize": 20971520,
  "isApplicationReadOnly": false,
  "maxExportItems": 250,
  "allowStatisticsCollection": true,
  "baseUrl": "https://example.youtrack.cloud",
  "$type": "SystemSettings"
}
```