---
title: "Change the network's system preferences"
type: reference
method: POST
path: /rest-api/system-preferences.do
tag: "System Preferences"
---

# Change the network's system preferences

`POST https://YOUR-NETWORK-DOMAIN/rest-api/system-preferences.do`

Changes only the settings the call names and leaves every other one as it is, so a client that knows one setting does not have to send the rest. Each one is checked the way the console checks it, and a call that fails a check changes nothing at all. A setting that could not be applied is named in ignoredFields, with the reason in ignoredFieldReasons -- a GDPR consent rule sent while the policy is DEFAULT is the usual one, because the policy decides whether those rules are used. Changing a limit or a GDPR rule takes effect for ad serving within a minute, when the caches reload. Requires the System Preferences console permission.

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `actionCustomParameterLogEnabled` | boolean | no | `true` | Log the custom parameters a conversion carried |
| `customParametersPassingStrategy` | string | no | `PER_ENTITY` | Whether a creative is given the custom parameters of the request: OFF, ON, or PER_ENTITY (per campaign) |
| `cookieLogEnabled` | boolean | no | `false` | Log the cookies an ad request carried |
| `cookieCollectingEnabledDefault` | boolean | no | `true` | Whether a new placement collects cookies by default |
| `maxAllowedFileSize` | integer | no | `204800` | Largest creative file, in bytes (1-2147483647) |
| `maxAllowedVideoFileSize` | integer | no | `20971520` | Largest video file, in bytes (1-2147483647) |
| `heavyCreativeWarnings` | boolean | no | `true` | Warn when a creative is heavier than the limits below |
| `heavyCreativeLimitKb` | integer | no | `300` | Heavy-creative limit for non-IAB sizes, in KB (1-1048576) |
| `heavyVideoLimitMb` | integer | no | `10` | Heavy-creative limit for video, in MB (1-10240) |
| `uniqueUserCountingSpan` | integer | no | `24` | How long one visitor counts as the same unique user, in hours |
| `impressionDelayInterval` | integer | no | `0` | Seconds to wait before an impression counts |
| `locationSourceDB` | string | no | `IP_2_LOCATION` | Which database turns an address into a location: SYSTEM_DEFAULT, IP_2_LOCATION or MAX_MIND |
| `domainExtractionStrategy` | string | no | `REFERER` | How the page domain is read: NONE, or REFERER with the parameter below |
| `domainExtractionParam` | string | no | `utm_source` | With REFERER: the query parameter the domain is taken from |
| `dailyAnalyticsRequestsLimit` | integer | no | `1000` | Analytics requests one account may run a day, 0 for no limit |
| `dailyAnalyticsDataRecordsLimit` | integer | no | `100000` | Rows one analytics request may return, 0 for no limit |
| `csvExportLimit` | integer | no | `500000` | Rows a CSV export may hold; leave it out to keep the current one |
| `xlsxExportLimit` | integer | no | `100000` | Rows an XLSX export may hold |
| `pdfExportLimit` | integer | no | `50000` | Rows a PDF export may hold |
| `htmlExportLimit` | integer | no | `50000` | Rows an HTML export may hold |
| `jsonExportLimit` | integer | no | `100000` | Rows a JSON export may hold |
| `compressReport` | boolean | no | `true` | Compress an export before sending it |
| `analyticsDateFormat` | string | no | `DEFAULT` | Date format of analytics reports: DEFAULT (dd-MM-yyyy) or US_FORMAT (MM-dd-yyyy) |
| `troubleshootLogSizeLimitMb` | integer | no | `1024` | Largest troubleshoot log, in MB (0-1048576) |
| `aiChatMonthlyLimitUsd` | string | no | `50` | What the in-product AI assistant may cost this network a month, in USD; empty for the platform default |
| `gdprPolicy` | string | no | `REQUIRE_IAB_CONSENT` | GDPR policy: DEFAULT serves as usual, REQUIRE_IAB_CONSENT applies the consent rules below |
| `gdprRestriction` | string | no | `NOT_SERVE` | What happens without consent: NOT_SERVE, RESTRICT_UID, RESTRICT_ALL or RESTRICT_ALL_AND_DATA_PROCESSING |
| `gdprIabVendorId` | integer | no | `849` | The IAB Global Vendor List id consent is checked for; required under REQUIRE_IAB_CONSENT |
| `gdprRestrictMediation` | boolean | no | `false` | Apply the restriction to mediation partners as well |
| `gdprCheckDisclosedVendors` | boolean | no | `false` | Require the vendor to be in the consent string's disclosed vendors |
| `gdprCmpListVerificationEnabled` | boolean | no | `false` | Check the CMP against the IAB Global CMP List |
| `gdprTcfPolicyVersionCheckEnabled` | boolean | no | `false` | Refuse a consent string below the TCF policy version floor |
| `gdprMinTcfPolicyVersion` | integer | no | `4` | The TCF policy version floor, 2-10 |
| `gdprGpcOptOutEnabled` | boolean | no | `true` | Treat a Global Privacy Control signal as an opt-out |
| `gdprPassPrivacySignalsToDsps` | boolean | no | `true` | Pass the privacy signals on to the DSPs in a bid request |

## Responses

- `200` — {success, changed:[...], ignoredFields:[...], ignoredFieldReasons:{...}}
- `400` — A value is outside the range the console allows, or a rule it enforces is broken
- `401` — Authentication error
- `403` — The caller does not hold the System Preferences permission

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/system-preferences.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'actionCustomParameterLogEnabled=true' \
  --data-urlencode 'customParametersPassingStrategy=PER_ENTITY' \
  --data-urlencode 'cookieLogEnabled=false'
```

Source: https://epom.com/ad-server/docs/api/system-preferences/post-system-preferences