> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/navixy-api/panel-api/resources/dealer/settings/service.md).

# Service Settings

Service settings in Navixy allow administrators to configure and customize various aspects of the monitoring service. These settings control the appearance and functionality of the platform, such as default maps, user interfaces, branding elements, and user registration options. By adjusting these parameters, administrators can tailor the platform to better meet the needs of their users and reflect their company's branding and operational requirements.

## Service settings object

## The ServiceSettings object

```json
{"openapi":"3.1.0","info":{"title":"Navixy Admin Panel API","version":"1.2.0"},"components":{"schemas":{"ServiceSettings":{"type":"object","description":"A dealer's service settings, as returned by the service settings read operation. Branding image paths are read-only here and are changed through the branding image operations.","properties":{"service_title":{"type":"string","description":"Name of the service."},"locale":{"type":"string","description":"Dealer's default locale."},"demo_login":{"type":"string","description":"Login the demo button authenticates with. Demo access is disabled when empty."},"demo_password":{"type":"string","description":"Password the demo button authenticates with. Demo access is disabled when empty."},"maps":{"type":"array","description":"Maps available in the monitoring interface, chosen from `allowed_maps`. Only free maps are available when the domain is a subdomain of the platform owner. Observed codes include `roadmap`, `satellite`, `hybrid`, `terrain`, `yandex`, `osm`, `osmmapnik`, `wikimapia`, `cdcom`, `doublegis`, `bing`, `bing_satellite`, `bing_hybrid`, and `kosmosnimki`.","items":{"type":"string"}},"default_map":{"$ref":"#/components/schemas/DefaultMap"},"currency":{"type":"string","description":"Currency code shown in the interface."},"payment_link":{"type":["string","null"],"description":"Link to the dealer's payment system."},"promo_url":{"type":["string","null"],"description":"Customizable \"About company\" URL."},"google_client_id":{"type":"string","description":"Google Maps client ID. Not yet supported by the interface."},"domain":{"type":"string","description":"Domain the monitoring interface is served on."},"favicon":{"type":["string","null"],"description":"Path or URL to the interface favicon. Read-only here."},"app_logo":{"type":["string","null"],"description":"Path or URL to the mobile app logotype. Read-only here."},"logo":{"type":["string","null"],"description":"Path or URL to the dealer logotype. Read-only here."},"document_logo":{"type":["string","null"],"description":"Path or URL to the logotype used in generated documents. Read-only here."},"login_wallpaper":{"type":["string","null"],"description":"Path or URL to the login page wallpaper. Read-only here."},"desktop_wallpaper":{"type":["string","null"],"description":"Path to the interface wallpaper. Read-only here."},"login_footer":{"type":["string","null"],"description":"Footer shown on the login page."},"allow_registration":{"type":"boolean","description":"When `true`, end users may register themselves."},"show_mobile_apps":{"type":"boolean","description":"When `true`, prompts visitors on mobile devices to install the mobile app rather than continue in the mobile web interface."},"default_user_settings":{"$ref":"#/components/schemas/DefaultUserSettings"},"display_model_features_link":{"type":"boolean","description":"When `true`, shows a link to navixy.com in device model information."},"limited_domain":{"type":"boolean","description":"`true` if the PaaS domain has limitations."},"allowed_maps":{"type":"array","description":"Maps the dealer may choose to include in `maps`. Set by the platform owner, not writable by the dealer.","items":{"type":"string"}},"color_theme":{"type":"string","description":"Interface colour theme code. Empty string selects the default theme.","maxLength":128},"app_color_theme":{"type":"string","description":"Mobile app colour theme code. Empty string selects the default theme.","maxLength":128},"privacy_policy_link":{"type":["string","null"],"description":"Link to the privacy policy."},"tos":{"type":["string","null"],"description":"Terms of service text."},"no_register_commands":{"type":"boolean","description":"When `true`, the platform does not send configuration commands to devices on activation."},"default_user_time_zone":{"type":"string","description":"Time zone ID applied to users created through the user upload operation, and preselected when creating a user in the Admin Panel."},"email_special":{"type":"string","description":"Address used for PaaS reports. Also returned by the notification settings read operation."},"monitoring_logo":{"type":["string","null"],"description":"Path or URL to the logotype shown inside the monitoring interface. Read-only here."},"monitoring_logo_clickable":{"type":"boolean","description":"When `true`, the monitoring interface logotype links to the dealer's promo URL."},"has_https":{"type":"boolean","description":"`true` if the dealer's domain is served over HTTPS."},"no_auto_create_rules":{"type":"boolean","description":"When `true`, the platform does not create default rules for newly registered devices."},"no_auto_create_sensors":{"type":"boolean","description":"When `true`, the platform does not create default sensors for newly registered devices."},"display_release_notes":{"type":"boolean","description":"When `true`, release notes are shown to end users."},"show_call_notifications":{"type":"boolean","description":"When `true`, call notifications are shown in the end user interface."},"captcha_provider":{"type":"string","description":"CAPTCHA provider used on registration and login forms."},"gis_package":{"type":"string","description":"GIS package active for this dealer."},"gis_package_definition":{"type":["object","null"],"description":"Detailed definition of the active GIS package, or `null` when the package is a standard one."},"geocoders":{"type":"array","description":"Geocoders available for selection. Empty when the platform defaults apply.","items":{"type":"string"}},"route_providers":{"type":"array","description":"Route providers available for selection. Empty when the platform defaults apply.","items":{"type":"string"}},"lbs_providers":{"type":"array","description":"Location-by-cell-tower providers available for selection. Empty when the platform defaults apply.","items":{"type":"string"}},"matrix_providers":{"type":"array","description":"Distance matrix providers available for selection. Empty when the platform defaults apply.","items":{"type":"string"}},"information_center":{"$ref":"#/components/schemas/InformationCenter"}}},"DefaultMap":{"type":"object","description":"The map, position, and zoom the monitoring interface opens on.","properties":{"type":{"type":"string","description":"Map code. Must be one of the maps listed in `maps`."},"location":{"$ref":"#/components/schemas/Location"},"zoom":{"type":"integer","description":"Zoom level."}}},"Location":{"type":"object","description":"A geographic point.","properties":{"lat":{"type":"number","description":"Latitude in degrees."},"lng":{"type":"number","description":"Longitude in degrees."}}},"DefaultUserSettings":{"type":"object","description":"Settings applied by default to the dealer's newly created end users.","properties":{"geocoder":{"type":"string","description":"Default geocoder."},"route_provider":{"type":"string","description":"Default route provider."},"measurement_system":{"type":"string","description":"Measurement system.","enum":["metric","imperial"]},"date_format":{"type":"string","description":"Date representation."},"hour_mode":{"type":"string","description":"Time representation.","enum":["TWELVE_HOURS","TWENTY_FOUR_HOURS"]},"translit":{"type":"boolean","description":"When `true`, transliterates SMS text, replacing national alphabet characters with close Latin ones to reduce message length."}}},"InformationCenter":{"type":"object","description":"Visibility and source of the help content panels shown to end users.","properties":{"release_notes":{"$ref":"#/components/schemas/InformationCenterSection"},"user_guides":{"$ref":"#/components/schemas/InformationCenterSection"}}},"InformationCenterSection":{"type":"object","description":"One information centre panel.","properties":{"visible":{"type":"boolean","description":"`true` if the panel is shown to end users."},"content":{"type":"object","description":"Where the panel's content comes from.","properties":{"type":{"type":"string","description":"Content source. `default` uses Navixy-supplied content."}}}}}}}}
```

Notes on individual fields:

* `locale`, `currency`, `maps`, `allowed_maps`, and `default_map.type` use platform-wide enums described in the [data types](/docs/navixy-api/user-api/backend-api.md#data-types) section.
* Branding image paths, that is `favicon`, `logo`, `app_logo`, `document_logo`, `monitoring_logo`, `login_wallpaper`, and `desktop_wallpaper`, are read-only here. Change them through the [branding image](/docs/navixy-api/panel-api/resources/dealer/settings/image.md) operations.
* `default_user_time_zone` is a [time zone ID](/docs/navixy-api/panel-api/resources/timezone.md) applied to users created via [user/upload](/docs/navixy-api/panel-api/resources/user.md#post-panel-user-upload).
* `email_special` is the same underlying value as `email_special` in the [notification settings](/docs/navixy-api/panel-api/resources/dealer/settings/notification.md#notification-settings-object).

## API actions

API path: `panel/dealer/settings/service`.

***

*required permissions*: `service_settings: "read"`.

## Read service settings

> Read the current dealer's service settings: branding paths, available maps and the default map, currency, locale, demo credentials, registration and mobile app behavior, colour themes, legal texts, and the defaults applied to newly created users. Takes no parameters beyond the session credential.

```json
{"openapi":"3.1.0","info":{"title":"Navixy Admin Panel API","version":"1.2.0"},"tags":[{"name":"Dealer","description":"Operations for reading dealer information, managing activation codes, changing the dealer password, and reading or updating panel settings covering service configuration, notification originators, and branding images. All resources under the /panel/dealer/ path."}],"servers":[{"url":"https://api.eu.navixy.com/v2","description":"Navixy production server on European platform"},{"url":"https://api.us.navixy.com/v2","description":"Navixy production server on American platform"},{"url":"https://api.me.navixy.com/v2","description":"Navixy production server on Middle East platform"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","description":"Enter the panel session hash with the \"NVX \" prefix, e.g. \"NVX fa7bf873fab9333144e171372a321b06\". Obtain the hash from the accountAuth operation.","name":"Authorization","in":"header"}},"schemas":{"ServiceSettings":{"type":"object","description":"A dealer's service settings, as returned by the service settings read operation. Branding image paths are read-only here and are changed through the branding image operations.","properties":{"service_title":{"type":"string","description":"Name of the service."},"locale":{"type":"string","description":"Dealer's default locale."},"demo_login":{"type":"string","description":"Login the demo button authenticates with. Demo access is disabled when empty."},"demo_password":{"type":"string","description":"Password the demo button authenticates with. Demo access is disabled when empty."},"maps":{"type":"array","description":"Maps available in the monitoring interface, chosen from `allowed_maps`. Only free maps are available when the domain is a subdomain of the platform owner. Observed codes include `roadmap`, `satellite`, `hybrid`, `terrain`, `yandex`, `osm`, `osmmapnik`, `wikimapia`, `cdcom`, `doublegis`, `bing`, `bing_satellite`, `bing_hybrid`, and `kosmosnimki`.","items":{"type":"string"}},"default_map":{"$ref":"#/components/schemas/DefaultMap"},"currency":{"type":"string","description":"Currency code shown in the interface."},"payment_link":{"type":["string","null"],"description":"Link to the dealer's payment system."},"promo_url":{"type":["string","null"],"description":"Customizable \"About company\" URL."},"google_client_id":{"type":"string","description":"Google Maps client ID. Not yet supported by the interface."},"domain":{"type":"string","description":"Domain the monitoring interface is served on."},"favicon":{"type":["string","null"],"description":"Path or URL to the interface favicon. Read-only here."},"app_logo":{"type":["string","null"],"description":"Path or URL to the mobile app logotype. Read-only here."},"logo":{"type":["string","null"],"description":"Path or URL to the dealer logotype. Read-only here."},"document_logo":{"type":["string","null"],"description":"Path or URL to the logotype used in generated documents. Read-only here."},"login_wallpaper":{"type":["string","null"],"description":"Path or URL to the login page wallpaper. Read-only here."},"desktop_wallpaper":{"type":["string","null"],"description":"Path to the interface wallpaper. Read-only here."},"login_footer":{"type":["string","null"],"description":"Footer shown on the login page."},"allow_registration":{"type":"boolean","description":"When `true`, end users may register themselves."},"show_mobile_apps":{"type":"boolean","description":"When `true`, prompts visitors on mobile devices to install the mobile app rather than continue in the mobile web interface."},"default_user_settings":{"$ref":"#/components/schemas/DefaultUserSettings"},"display_model_features_link":{"type":"boolean","description":"When `true`, shows a link to navixy.com in device model information."},"limited_domain":{"type":"boolean","description":"`true` if the PaaS domain has limitations."},"allowed_maps":{"type":"array","description":"Maps the dealer may choose to include in `maps`. Set by the platform owner, not writable by the dealer.","items":{"type":"string"}},"color_theme":{"type":"string","description":"Interface colour theme code. Empty string selects the default theme.","maxLength":128},"app_color_theme":{"type":"string","description":"Mobile app colour theme code. Empty string selects the default theme.","maxLength":128},"privacy_policy_link":{"type":["string","null"],"description":"Link to the privacy policy."},"tos":{"type":["string","null"],"description":"Terms of service text."},"no_register_commands":{"type":"boolean","description":"When `true`, the platform does not send configuration commands to devices on activation."},"default_user_time_zone":{"type":"string","description":"Time zone ID applied to users created through the user upload operation, and preselected when creating a user in the Admin Panel."},"email_special":{"type":"string","description":"Address used for PaaS reports. Also returned by the notification settings read operation."},"monitoring_logo":{"type":["string","null"],"description":"Path or URL to the logotype shown inside the monitoring interface. Read-only here."},"monitoring_logo_clickable":{"type":"boolean","description":"When `true`, the monitoring interface logotype links to the dealer's promo URL."},"has_https":{"type":"boolean","description":"`true` if the dealer's domain is served over HTTPS."},"no_auto_create_rules":{"type":"boolean","description":"When `true`, the platform does not create default rules for newly registered devices."},"no_auto_create_sensors":{"type":"boolean","description":"When `true`, the platform does not create default sensors for newly registered devices."},"display_release_notes":{"type":"boolean","description":"When `true`, release notes are shown to end users."},"show_call_notifications":{"type":"boolean","description":"When `true`, call notifications are shown in the end user interface."},"captcha_provider":{"type":"string","description":"CAPTCHA provider used on registration and login forms."},"gis_package":{"type":"string","description":"GIS package active for this dealer."},"gis_package_definition":{"type":["object","null"],"description":"Detailed definition of the active GIS package, or `null` when the package is a standard one."},"geocoders":{"type":"array","description":"Geocoders available for selection. Empty when the platform defaults apply.","items":{"type":"string"}},"route_providers":{"type":"array","description":"Route providers available for selection. Empty when the platform defaults apply.","items":{"type":"string"}},"lbs_providers":{"type":"array","description":"Location-by-cell-tower providers available for selection. Empty when the platform defaults apply.","items":{"type":"string"}},"matrix_providers":{"type":"array","description":"Distance matrix providers available for selection. Empty when the platform defaults apply.","items":{"type":"string"}},"information_center":{"$ref":"#/components/schemas/InformationCenter"}}},"DefaultMap":{"type":"object","description":"The map, position, and zoom the monitoring interface opens on.","properties":{"type":{"type":"string","description":"Map code. Must be one of the maps listed in `maps`."},"location":{"$ref":"#/components/schemas/Location"},"zoom":{"type":"integer","description":"Zoom level."}}},"Location":{"type":"object","description":"A geographic point.","properties":{"lat":{"type":"number","description":"Latitude in degrees."},"lng":{"type":"number","description":"Longitude in degrees."}}},"DefaultUserSettings":{"type":"object","description":"Settings applied by default to the dealer's newly created end users.","properties":{"geocoder":{"type":"string","description":"Default geocoder."},"route_provider":{"type":"string","description":"Default route provider."},"measurement_system":{"type":"string","description":"Measurement system.","enum":["metric","imperial"]},"date_format":{"type":"string","description":"Date representation."},"hour_mode":{"type":"string","description":"Time representation.","enum":["TWELVE_HOURS","TWENTY_FOUR_HOURS"]},"translit":{"type":"boolean","description":"When `true`, transliterates SMS text, replacing national alphabet characters with close Latin ones to reduce message length."}}},"InformationCenter":{"type":"object","description":"Visibility and source of the help content panels shown to end users.","properties":{"release_notes":{"$ref":"#/components/schemas/InformationCenterSection"},"user_guides":{"$ref":"#/components/schemas/InformationCenterSection"}}},"InformationCenterSection":{"type":"object","description":"One information centre panel.","properties":{"visible":{"type":"boolean","description":"`true` if the panel is shown to end users."},"content":{"type":"object","description":"Where the panel's content comes from.","properties":{"type":{"type":"string","description":"Content source. `default` uses Navixy-supplied content."}}}}}},"responses":{"ResponseError":{"description":"Error response object","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Always false."},"status":{"type":"object","description":"Error status. Present only when an error occurred.","properties":{"code":{"type":"integer","description":"An error code in this API (not a HTTP code)"},"description":{"type":"string","description":"An error description"}}},"errors":{"type":"array","description":"Per-parameter detail, returned with validation failures such as error code 7.","items":{"type":"object","properties":{"parameter":{"type":"string","description":"Name of the parameter that failed validation."},"error":{"type":"string","description":"What was wrong with it."}}}}}}}}}}},"paths":{"/panel/dealer/settings/service/read":{"post":{"tags":["Dealer"],"summary":"Read service settings","description":"Read the current dealer's service settings: branding paths, available maps and the default map, currency, locale, demo credentials, registration and mobile app behavior, colour themes, legal texts, and the defaults applied to newly created users. Takes no parameters beyond the session credential.","operationId":"dealerSettingsServiceRead","responses":{"200":{"description":"Service settings","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"`true` if request finished successfully.","readOnly":true},"value":{"$ref":"#/components/schemas/ServiceSettings"}}}}}},"400":{"description":"Bad request. The response body carries the API-level error code in `status.code`. Validation failures also include an `errors` array.","$ref":"#/components/responses/ResponseError"},"403":{"description":"Operation not permitted, error code 13: the session lacks the required permission.","$ref":"#/components/responses/ResponseError"},"default":{"$ref":"#/components/responses/ResponseError"}}}}}}
```

#### Errors

[General](/docs/navixy-api/user-api/backend-api/errors.md#error-codes) types only.

***

*required permissions*: `service_settings: "update"`.

{% hint style="danger" %}
This is a full replacement, and it covers more fields than the request schema lists. Any writable setting you omit is reset to its default, including settings the schema does not enumerate.

Sending only the fields documented as parameters was observed to silently clear `email_special` and flip `no_auto_create_rules` from `true` to `false`.

Only `allow_registration`, `show_mobile_apps`, and `default_user_time_zone` are preserved when omitted. Every other writable setting is reset.

Always call [Read service settings](#post-panel-dealer-settings-service-read) first, change the fields you intend to change, and send everything back. Do not build a request from the schema alone.
{% endhint %}

Wallpapers, logos, and favicons cannot be edited here. Use the [branding image](/docs/navixy-api/panel-api/resources/dealer/settings/image.md) operations instead.

## Update service settings

> Update the current dealer's service settings. Branding images, that is wallpapers, logos, and favicons, cannot be changed here: use the branding image upload and delete operations instead.\
> \
> \*\*This is a full replacement, not a partial update, and it covers more fields than are listed below.\*\* Any writable setting you omit is reset to its default, including settings this schema does not enumerate. Sending only the fields documented here was observed to silently clear \`email\_special\` and flip \`no\_auto\_create\_rules\` from \`true\` to \`false\`.\
> \
> Always call the service settings read operation first, modify the fields you intend to change, and send everything back. Do not construct a request from this schema alone.

```json
{"openapi":"3.1.0","info":{"title":"Navixy Admin Panel API","version":"1.2.0"},"tags":[{"name":"Dealer","description":"Operations for reading dealer information, managing activation codes, changing the dealer password, and reading or updating panel settings covering service configuration, notification originators, and branding images. All resources under the /panel/dealer/ path."}],"servers":[{"url":"https://api.eu.navixy.com/v2","description":"Navixy production server on European platform"},{"url":"https://api.us.navixy.com/v2","description":"Navixy production server on American platform"},{"url":"https://api.me.navixy.com/v2","description":"Navixy production server on Middle East platform"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","description":"Enter the panel session hash with the \"NVX \" prefix, e.g. \"NVX fa7bf873fab9333144e171372a321b06\". Obtain the hash from the accountAuth operation.","name":"Authorization","in":"header"}},"schemas":{"ServiceSettingsUpdate":{"type":"object","description":"The writable subset of a dealer's service settings. Branding images, that is wallpapers, logos, and favicons, are absent by design and are changed through the branding image operations instead.","properties":{"service_title":{"type":"string","description":"Name of the service.","maxLength":100},"demo_login":{"type":"string","description":"Login the demo button authenticates with. Demo access is disabled when empty.","maxLength":50},"demo_password":{"type":"string","description":"Password the demo button authenticates with. Demo access is disabled when empty.","maxLength":50},"maps":{"type":"array","description":"Maps available in the monitoring interface. Must be a subset of `allowed_maps` as returned by the service settings read operation.","items":{"type":"string"}},"default_map":{"$ref":"#/components/schemas/DefaultMap"},"currency":{"type":"string","description":"Currency code shown in the interface."},"payment_link":{"type":["string","null"],"description":"Link to the dealer's payment system.","format":"uri"},"promo_url":{"type":["string","null"],"description":"Customizable \"About company\" URL.","format":"uri"},"google_client_id":{"type":"string","description":"Google Maps client ID."},"domain":{"type":"string","description":"Domain the monitoring interface is served on. Must not already be used by another dealer.","maxLength":255},"login_footer":{"type":["string","null"],"description":"Footer shown on the login page."},"allow_registration":{"type":"boolean","description":"When `true`, end users may register themselves."},"show_mobile_apps":{"type":"boolean","description":"When `true`, prompts visitors on mobile devices to install the mobile app."},"default_user_settings":{"$ref":"#/components/schemas/DefaultUserSettings"},"display_model_features_link":{"type":"boolean","description":"When `true`, shows a link to navixy.com in device model information."},"color_theme":{"type":"string","description":"Interface colour theme code. Empty string selects the default theme.","maxLength":128},"app_color_theme":{"type":"string","description":"Mobile app colour theme code. Empty string selects the default theme.","maxLength":128},"privacy_policy_link":{"type":["string","null"],"description":"Link to the privacy policy.","maxLength":200},"tos":{"type":["string","null"],"description":"Terms of service text.","maxLength":20000},"no_register_commands":{"type":"boolean","description":"When `true`, the platform does not send configuration commands to devices on activation."},"default_user_time_zone":{"type":"string","description":"Time zone ID applied to newly created users."},"email_special":{"type":["string","null"],"description":"Address used for PaaS reports. Writable here as well as through the notification settings update, where it is the same underlying value. Omitting it clears it.","maxLength":255},"no_auto_create_rules":{"type":"boolean","description":"When `true`, the platform does not create default rules for newly registered devices. Omitting it resets it to `false`."},"locale":{"type":"string","description":"Dealer's default locale."},"monitoring_logo_clickable":{"type":"boolean","description":"When `true`, the monitoring interface logotype links to the dealer's promo URL."}},"required":["domain","service_title","locale","demo_login","demo_password","maps","default_map","currency","color_theme","app_color_theme"]},"DefaultMap":{"type":"object","description":"The map, position, and zoom the monitoring interface opens on.","properties":{"type":{"type":"string","description":"Map code. Must be one of the maps listed in `maps`."},"location":{"$ref":"#/components/schemas/Location"},"zoom":{"type":"integer","description":"Zoom level."}}},"Location":{"type":"object","description":"A geographic point.","properties":{"lat":{"type":"number","description":"Latitude in degrees."},"lng":{"type":"number","description":"Longitude in degrees."}}},"DefaultUserSettings":{"type":"object","description":"Settings applied by default to the dealer's newly created end users.","properties":{"geocoder":{"type":"string","description":"Default geocoder."},"route_provider":{"type":"string","description":"Default route provider."},"measurement_system":{"type":"string","description":"Measurement system.","enum":["metric","imperial"]},"date_format":{"type":"string","description":"Date representation."},"hour_mode":{"type":"string","description":"Time representation.","enum":["TWELVE_HOURS","TWENTY_FOUR_HOURS"]},"translit":{"type":"boolean","description":"When `true`, transliterates SMS text, replacing national alphabet characters with close Latin ones to reduce message length."}}}},"responses":{"OK":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"`true` if request finished successfully.","readOnly":true}}}}}},"ResponseError":{"description":"Error response object","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Always false."},"status":{"type":"object","description":"Error status. Present only when an error occurred.","properties":{"code":{"type":"integer","description":"An error code in this API (not a HTTP code)"},"description":{"type":"string","description":"An error description"}}},"errors":{"type":"array","description":"Per-parameter detail, returned with validation failures such as error code 7.","items":{"type":"object","properties":{"parameter":{"type":"string","description":"Name of the parameter that failed validation."},"error":{"type":"string","description":"What was wrong with it."}}}}}}}}}}},"paths":{"/panel/dealer/settings/service/update":{"post":{"tags":["Dealer"],"summary":"Update service settings","description":"Update the current dealer's service settings. Branding images, that is wallpapers, logos, and favicons, cannot be changed here: use the branding image upload and delete operations instead.\n\n**This is a full replacement, not a partial update, and it covers more fields than are listed below.** Any writable setting you omit is reset to its default, including settings this schema does not enumerate. Sending only the fields documented here was observed to silently clear `email_special` and flip `no_auto_create_rules` from `true` to `false`.\n\nAlways call the service settings read operation first, modify the fields you intend to change, and send everything back. Do not construct a request from this schema alone.","operationId":"dealerSettingsServiceUpdate","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceSettingsUpdate"}}}},"responses":{"200":{"$ref":"#/components/responses/OK"},"400":{"description":"Bad request. The response body carries the API-level error code in `status.code`. Validation failures also include an `errors` array.","$ref":"#/components/responses/ResponseError"},"403":{"description":"Operation not permitted, error code 13: the session lacks the required permission.","$ref":"#/components/responses/ResponseError"},"409":{"description":"Entity already exists, error code 247: the domain is already used by another dealer","$ref":"#/components/responses/ResponseError"},"default":{"$ref":"#/components/responses/ResponseError"}}}}}}
```

#### Errors

* 247 - Entity already exists(409) - when `domain` already used by other dealer.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/navixy-api/panel-api/resources/dealer/settings/service.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.