> 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/user-api/resources/tracking/tracker/settings/special.md).

# Special

Model-specific settings that only some device models expose, each with its own object shape.

Some device models expose a kind of control that others do not: an electronic lock, a panic button, a power-off key. Which one, if any, a model has is reported by the `special_control` field of its [model](/docs/navixy-api/user-api/resources/tracking/tracker.md#post-tracker-list_models). A value of `none` means the model has no such control.

When a model does have one, `special_control` names the settings `type` that goes with it, such as `pwr_off_key` or `sos_key`. That type is what decides the shape of the settings object, and every shape is catalogued in [Settings object structures by type](#settings-object-structures-by-type) below.

Three operations act on a model's special control:

* Read its settings with [`tracker/settings/special/read`](#post-tracker-settings-special-read).
* Change them with [`tracker/settings/special/update`](#post-tracker-settings-special-update).
* Perform the control itself with [`tracker/send_command`](/docs/navixy-api/user-api/resources/tracking/tracker.md#post-tracker-send_command), whose `special_settings` parameter takes the same object.

## API actions

API base path: `/tracker/settings/special`.

***

## Read special settings

> Get the model-specific special settings for a tracker. Available to demo accounts.\
> \
> \*\*The response shape depends on whether you pass \`type\`.\*\* With it, the settings object comes back under \`value\`; without it, every special-settings object the tracker has comes back under \`list\`.

```json
{"openapi":"3.1.0","info":{"title":"Navixy Platform API","version":"1.0.0"},"tags":[{"name":"Trackers","description":"Trackers, the devices the platform tracks, together with the geo links that share their live location with people outside the account. Resources under the /tracker/ 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":"Either a user session hash or an API key, with the \"NVX \" prefix, for example \"NVX 22eac1c27af4be7b9d04da2ce1af111b\". Obtain a session hash from the userAuth operation, or create an API key from the API keys operations. A small number of operations accept a session hash only and reject an API key with error code 4; each says so in its description.","name":"Authorization","in":"header"}},"schemas":{"SpecialSettings":{"type":"object","description":"One special-settings object. Its `type` decides which further fields it carries, and the full catalogue of types is on the special settings page rather than here, because the set is long and model-specific.\n\nNote that `device_status_settings`, carrying `offline_timeout_seconds`, is returned by the API but is missing from that catalogue.","properties":{"type":{"type":"string","description":"Which kind of special settings this object holds, for example `electronic_lock_password` or `time_shift`."}},"required":["type"],"additionalProperties":true}},"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 an 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. A parameter name here may be an internal field name rather than the documented parameter name.","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":{"/tracker/settings/special/read":{"post":{"tags":["Trackers"],"summary":"Read special settings","description":"Get the model-specific special settings for a tracker. Available to demo accounts.\n\n**The response shape depends on whether you pass `type`.** With it, the settings object comes back under `value`; without it, every special-settings object the tracker has comes back under `list`.","operationId":"trackerSettingsSpecialRead","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tracker_id":{"type":"integer","description":"ID of the tracker, also known as the object ID. Must belong to the current account and not be blocked."},"type":{"type":"string","description":"Optional. Which kind of special settings to read. Omit to get all of them."}},"required":["tracker_id"]}}}},"responses":{"200":{"description":"The special settings","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"`true` if request finished successfully.","readOnly":true},"value":{"allOf":[{"$ref":"#/components/schemas/SpecialSettings"}],"description":"Returned when `type` was given."},"list":{"type":"array","description":"Returned when `type` was omitted.","items":{"$ref":"#/components/schemas/SpecialSettings"}}}}}}},"400":{"description":"Bad request. The response body carries the API-level error code in `status.code`. Validation failures also include an `errors` array naming each offending parameter.","$ref":"#/components/responses/ResponseError"},"403":{"description":"Error 201: no tracker with this ID belongs to the account. Error 208: the tracker exists but is blocked, normally because its tariff ended. Error 214: the device does not support this operation.","$ref":"#/components/responses/ResponseError"},"default":{"$ref":"#/components/responses/ResponseError"}}}}}}
```

#### Errors

These errors come in addition to the [general error codes](/docs/navixy-api/general/errors.md#error-codes):

* 201 - No tracker with this ID belongs to the account.
* 208 - The tracker exists but is blocked, normally because its tariff ended.
* 214 - The device does not support this operation.

***

*Required sub-user rights:* `tracker_configure`.

## Change special settings

> Replace one special-settings object on a tracker.\
> \
> \*\*This reaches the hardware.\*\* The \`value\` object must carry the \`type\` that identifies which settings are being written.\
> \
> Requires the \`tracker\_configure\` right.

```json
{"openapi":"3.1.0","info":{"title":"Navixy Platform API","version":"1.0.0"},"tags":[{"name":"Trackers","description":"Trackers, the devices the platform tracks, together with the geo links that share their live location with people outside the account. Resources under the /tracker/ 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":"Either a user session hash or an API key, with the \"NVX \" prefix, for example \"NVX 22eac1c27af4be7b9d04da2ce1af111b\". Obtain a session hash from the userAuth operation, or create an API key from the API keys operations. A small number of operations accept a session hash only and reject an API key with error code 4; each says so in its description.","name":"Authorization","in":"header"}},"schemas":{"SpecialSettings":{"type":"object","description":"One special-settings object. Its `type` decides which further fields it carries, and the full catalogue of types is on the special settings page rather than here, because the set is long and model-specific.\n\nNote that `device_status_settings`, carrying `offline_timeout_seconds`, is returned by the API but is missing from that catalogue.","properties":{"type":{"type":"string","description":"Which kind of special settings this object holds, for example `electronic_lock_password` or `time_shift`."}},"required":["type"],"additionalProperties":true}},"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 an 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. A parameter name here may be an internal field name rather than the documented parameter name.","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":{"/tracker/settings/special/update":{"post":{"tags":["Trackers"],"summary":"Change special settings","description":"Replace one special-settings object on a tracker.\n\n**This reaches the hardware.** The `value` object must carry the `type` that identifies which settings are being written.\n\nRequires the `tracker_configure` right.","operationId":"trackerSettingsSpecialUpdate","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tracker_id":{"type":"integer","description":"ID of the tracker, also known as the object ID. Must belong to the current account and not be blocked."},"value":{"allOf":[{"$ref":"#/components/schemas/SpecialSettings"}],"description":"The settings object to write, including its `type`."}},"required":["tracker_id","value"]}}}},"responses":{"200":{"description":"The settings were sent","$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 naming each offending parameter.","$ref":"#/components/responses/ResponseError"},"403":{"description":"Error 201: no tracker with this ID belongs to the account. Error 208: the tracker exists but is blocked, normally because its tariff ended. Error 214: the device does not support this operation.","$ref":"#/components/responses/ResponseError"},"default":{"$ref":"#/components/responses/ResponseError"}}}}}}
```

#### Errors

These errors come in addition to the [general error codes](/docs/navixy-api/general/errors.md#error-codes):

* 201 - No tracker with this ID belongs to the account.
* 208 - The tracker exists but is blocked, normally because its tariff ended.
* 214 - The device does not support this operation.

## Settings object structures by type

**`electronic_lock_password`**

```json
{
  "type": "electronic_lock_password",
  "password": "password",
  "remember_password": false
}
```

* `password` - string. Nullable.

**`hhd_lock_password`**

```json
{
  "type": "hhd_lock_password",
  "password": "56894567",
  "remember_password": true
}
```

* `password` - string. Nullable. 8 digits.

**`jointech_lock_password`**

```json
{
  "type": "jointech_lock_password",
  "password": "d45s6w",
  "remember_password": false
}
```

* `password` - string. Nullable. 6 non-space, non-comma symbols.

**`vg_lock_password`**

```json
{
  "type": "vg_lock_password",
  "password": "123456",
  "remember_password": true
}
```

* `password` - string. Nullable. 6 digits.

**`autofon_sms_alerts`**

```json
{
  "type": "autofon_sms_alerts",
  "low_battery_mode": "enable",
  "ext_input_mode": "disable",
  "sos_button_mode": "enable"
}
```

* `low_battery_mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `ext_input_mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `sos_button_mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.

**`auto_geofence_telfm`**

```json
{
  "type": "auto_geofence_telfm",
  "mode": "enable",
  "activation_timeout": 300,
  "radius": 50
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `activation_timeout` - int. 0-65535 seconds.
* `radius` - int. 50 - 10000 meters.

**`bce_tacho_control`**

```json
{
  "type": "bce_tacho_control",
  "function": "slot1"
}
```

* `function` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `slot1` | `slot2` | `vu_activities` | `vu_no_activities`

**`call_button`**

```json
{
  "type": "call_button",
  "capacity": 1,
  "items": [
    {
      "phone": "45641784111"
    }
  ]
}
```

* `items` - Array of phone numbers (10-15 digits) represented as strings.
  * `phone` - string. Phone number in the international format without "+" sign.

**`call_buttons_v40`**

```json
{
  "type": "call_buttons_v40",
  "capacity": 4,
  "items": [
    {
      "phone": "45641784111"
    }
  ]
}
```

* `items` - Array of phone numbers (10-15 digits) represented as strings.
  * `phone` - string. Phone number in the international format without "+" sign.

**`careu_psm`**

```json
{
  "type": "careu_psm",
  "sleep_when_ignition_off": true,
  "sleep_when_no_motion": true,
  "sleep_when_no_communication": true,
  "sleep_conditions_duration": 1,
  "deep_sleep_conditions_duration": 300,
  "wake_up_interval": 30,
  "wake_up_from_dsm_interval": 2
}
```

* `sleep_when_ignition_off` - boolean.
* `sleep_when_no_motion` - boolean.
* `sleep_when_no_communication` - boolean.
* `sleep_conditions_duration` - int. Delay between the moment when conditions met and sleep mode activation in minutes. Can be 1-255.
* `deep_sleep_conditions_duration` - int. Delay between sleep mode activation and deep sleep mode activation in minutes. Can be 0-65535.
* `wake_up_interval` - int. Delay before waking up from sleep mode in minutes. Can be 0-65535.
* `wake_up_from_dsm_interval` - int. Delay before waking up from deep sleep mode in hours. Can be 0-255.
* `0` in these fields means don't switch.

**`castel_alarms`**

```json
{
  "type": "castel_alarms",
  "acceleration": {
    "report": true,
    "beep": true,
    "threshold": 0.4
  },
  "deceleration": {
    "report": false,
    "beep": false,
    "threshold": 0.7
  },
  "crash": {
    "report": true,
    "beep": true,
    "threshold": 1.0
  },
  "sharp_turn": {
    "report": true,
    "beep": true,
    "threshold": 0.3
  }
}
```

* `report` - boolean. If `true` will send notification to server upon an event.
* `beep` - boolean. If `true` will sound upon an event.
* `threshold` - double. Normal values range where event does not occur. Each unit equals 1 g.
  * `acceleration` - 0.2 - 0.8.
  * `deceleration` - 0.3 - 1.0.
  * `crash` - 1.0 - 2.0.
  * `sharp_turn` - 0.3 - 0.9.

**`castel_obd`**

```json
{
  "type": "castel_obd",
  "enable_pid_reports": true,
  "pid_data_records_per_message": 1,
  "pid_data_collect_interval": 30
}
```

* `enable_pid_reports` - boolean.
* `pid_data_records_per_message` - int. Count of records per one message. Can be 1 - 20.
* `pid_data_collect_interval` - int. Data collect interval in seconds. Can be 30 - 600.

**`charging_gmt100`**

```json
{
  "type": "charging_gmt100",
  "mode": "on_need"
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `on_need` | `ign_on_only` | `ign_on` | `low_charge`.

**`ddd_emails`**

```json
{
  "type": "ddd_emails",
  "emails": ["test@email.com", "example@email.com"]
}
```

* `emails` - string array. Valid emails. Maximum size 5.

**`digital_password`**

```json
{
  "type": "digital_password",
  "password": "123456"
}
```

* `password` - string. 6 digits.

**`fcc_telfm`**

```json
{
  "type": "fcc_telfm",
  "fuel_type": "gasoline",
  "engine_volume": 10.0,
  "multiplier": 0.0
}
```

* `fuel_type` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `gasoline` | `diesel` | `lpg`.
* `engine_volume` - double. Can be 0.0 - 10.0.
* `multiplier` - double. Can be 0.0 - 10.0.

**`galileo_tacho_control`**

```json
{
  "type": "galileo_tacho_control",
  "function": "download"
}
```

**`galileo_hds`**

```json
{
  "type": "galileo_hds",
  "mode": "enable",
  "max_acceleration_force": 1.26,
  "max_braking_force": 1.59,
  "max_cornering_force": 0.75
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `max_acceleration_force` - double. It is a max allowed acceleration force which can be reached while accelerating without triggering harsh acceleration event.Can be 0 - 2.55.
* `max_braking_force` - double. It is a max allowed braking force which can be reached while braking without triggering harsh braking event. Can be 0 - 2.55.
* `max_cornering_force` - double. It is a max allowed cornering angle which can be reached while cornering without triggering harsh cornering event. Can be 0 - 2.55.

**`harsh_behavior_hua_sheng`**

```json
{
  "type": "harsh_behavior_hua_sheng",
  "mode": "enable",
  "max_acceleration_force": 1.0,
  "max_braking_force": 0.5,
  "max_cornering_force": 0.1
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `max_acceleration_force` - double. It is a max allowed acceleration force which can be reached while accelerating without triggering harsh acceleration event.Can be 0.1 - 1.0.
* `max_braking_force` - double. It is a max allowed braking force which can be reached while braking without triggering harsh braking event. Can be 0.1 - 1.0.
* `max_cornering_force` - double. It is a max allowed cornering angle which can be reached while cornering without triggering harsh cornering event. Can be 0.1 - 1.0.

**`hbm_telfm`**

```json
{
  "type": "hbm_telfm",
  "mode": "enable",
  "max_acceleration_force": 0.3,
  "max_braking_force": 0.85,
  "max_angular_velocity": 0.1
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `max_acceleration_force` - double. It is a max allowed acceleration force which can be reached while accelerating without triggering harsh acceleration event. Can be 0.25 - 0.85 g.
* `max_braking_force` - double. It is a max allowed braking force which can be reached while braking without triggering harsh braking event. Can be 0.25 - 0.85 g.
* `max_cornering_force` - double. It is a max allowed cornering angle which can be reached while cornering without triggering harsh cornering event. Can be 0.1 - 1.0 rad/s.

**`hbm_telfm5x`**

```json
{
  "type": "hbm_telfm5x",
  "mode": "enable",
  "max_acceleration_force": 0.5,
  "max_braking_force": 3.0,
  "max_angular_velocity": 10.0
}
```

* `max_acceleration_force` - double. It is a max allowed acceleration force which can be reached while accelerating without triggering harsh acceleration event. Can be 0.5 - 10.0 g.
* `max_braking_force` - double. It is a max allowed braking force which can be reached while braking without triggering harsh braking event. Can be 0.5 - 10.0 g.
* `max_angular_velocity` - double. It is a max allowed cornering angle which can be reached while cornering without triggering harsh cornering event. Can be 0.5 - 10.0 rad/s.

**`hbm_ql`**

```json
{
  "type": "hbm_ql",
  "mode": "enable",
  "high_speed": 100,
  "high_speed_braking_delta": 50,
  "high_speed_acceleration_delta": 50,
  "medium_speed": 70,
  "medium_speed_braking_delta": 50,
  "medium_speed_acceleration_delta": 50,
  "low_speed_braking_delta": 50,
  "low_speed_acceleration_delta": 50
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `high_speed` - int. Can be 100 - 400.
* `high_speed_braking_delta` - int. Can be 0 - 100.
* `high_speed_acceleration_delta` - int. Can be 0 - 100.
* `medium_speed` - int. Can be 60 - 100.
* `medium_speed_braking_delta` - int. Can be 0 - 100.
* `medium_speed_acceleration_delta` - int. Can be 0 - 100.
* `low_speed_braking_delta` - int. Can be 0 - 100.
* `low_speed_acceleration_delta` - int. Can be 0 - 100.

**`hbm_ms_ql`**

```json
{
  "type": "hbm_ms_ql",
  "mode": "gps_only",
  "high_speed": 100,
  "high_speed_braking_delta": 50,
  "high_speed_acceleration_delta": 50,
  "medium_speed": 60,
  "medium_speed_braking_delta": 50,
  "medium_speed_acceleration_delta": 50,
  "low_speed_braking_delta": 50,
  "low_speed_acceleration_delta": 50,
  "turn_brake_threshold": 30,
  "turn_brake_duration": 320,
  "acceleration_threshold": 15,
  "acceleration_duration": 1200
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `disable` | `gps_only` | `motion_sensor_only` | `gps_and_motion_sensor`.
* `high_speed` - int. Can be 100 - 400.
* `high_speed_braking_delta` - int. Can be 0 - 100.
* `high_speed_acceleration_delta` - int. Can be 0 - 100.
* `medium_speed` - int. Can be 60 - 100.
* `medium_speed_braking_delta` - int. Can be 0 - 100.
* `medium_speed_acceleration_delta` - int. Can be 0 - 100.
* `low_speed_braking_delta` - int. Can be 0 - 100.
* `low_speed_acceleration_delta` - int. Can be 0 - 100.
* `turn_brake_threshold` - int. Can be 30 - 70.
* `turn_brake_duration` - int. Can be 320 - 800 milliseconds.
* `acceleration_threshold` - int. Can be 15 - 50.
* `acceleration_duration` - int. Can be 400 - 2000 milliseconds.

**`harsh_behavior_bce`**

```json
{
  "type": "harsh_behavior_bce",
  "is_switched_off": false,
  "acceleration_limit": 0.04,
  "braking_limit": 1.21,
  "cornering_limit": 2.38
}
```

* `is_switched_off` - boolean.
* `acceleration_limit` - double. Can be 0.04 - 3.
* `braking_limit` - double. Can be 0.04 - 3.
* `cornering_limit` - double. Can be 0.04 - 3.

**`harsh_behavior_concox_x1`**

```json
{
  "type": "harsh_behavior_concox_x1",
  "acc_speed": 40,
  "acc_detection_time": 4,
  "braking_speed": 60,
  "braking_detection_time": 2
}
```

* `acc_speed` - int. Can be 0 - 100.
* `acc_detection_time` - int. Can be 0 - 10.
* `braking_speed` - int. Can be 0 - 100.
* `braking_detection_time` - int. Can be 0 - 10.

**`harsh_behavior_tramigo`**

```json
{
  "type": "harsh_behavior_tramigo",
  "mode": "enable",
  "max_acceleration_force": 0.5,
  "max_braking_force": 1.3
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `max_acceleration_force` - double. Can be 0.1 - 8.
* `max_braking_force` - double. Can be 0.1 - 8.

**`harsh_behavior_ruptela`**

```json
{
  "type": "harsh_behavior_ruptela",
  "braking_limit": 30,
  "acceleration_limit": 60
}
```

* `braking_limit` - int. Can be 0 - 100.
* `acceleration_limit` - int. Can be 0 - 100.

**`nimbelink_accel`**

```json
{
  "type": "nimbelink_accel",
  "mode": "enable",
  "x": 1.12,
  "y": 0.8,
  "z": 2.33
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `x` - double. Can be 0 - 2.55.
* `y` - double. Can be 0 - 2.55.
* `z` - double. Can be 0 - 2.55.

**`hua_sheng_vibration_sensitivity`**

```json
{
  "type": "hua_sheng_vibration_sensitivity",
  "sensitivity": "easy"
}
```

* `sensitivity` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `easy` | `normal` | `hard` | `hardest`.

**`ign_ruptela`**

For Ruptela devices. Represents configuration parameters related to ignition detection ("Engine detection" and "Custom ignition", as Ruptela documentation calls them).

[JSON-schema](https://json-schema.org):

```
{
  "$schema" : "http://json-schema.org/draft-07/schema#",
  "type" : "object",
  "properties" : {
    "mode" : {
      "$ref" : "ruptela_ignition_mode.json"
    },
    "use_voltage" : {
      "type" : [ "boolean", "null" ]
    },
    "voltage" : {
      "type" : [ "number", "null" ]
    }
  },
  "required" : [ "mode" ],
   "$id" : "ruptela-ignition.json"
}

{
  "$schema" : "http://json-schema.org/draft-07/schema#",
  "type" : "string",
  "enum" : [ "always_on", "din", "movement_sensor", "custom" ],
  "$id" : "ruptela_ignition_mode.json"
}
```

**`ign_src_suntech`**

```json
{
  "type": "ign_src_suntech",
  "mode": "power_voltage",
  "power_voltage_low_level": 12000,
  "power_voltage_high_level": 19000
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `power_voltage` | `din1` | `movement`.
* `power_voltage_low_level` - int. Can be 0 - 30000.
* `power_voltage_high_level` - int. Can be 0 - 30000.

**`ign_src_telfm`**

```json
{
  "type": "ign_src_telfm",
  "mode": "power_voltage",
  "power_voltage_low_level": 12000,
  "power_voltage_high_level": 24000
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `power_voltage` | `din1` | `movement`.
* `power_voltage_low_level` - int. Can be 0 - 30000.
* `power_voltage_high_level` - int. Can be 0 - 30000.

**`locus_sec`**

```json
{
  "type": "locus_sec",
  "signature": "signature",
  "sms_password": "23145",
  "reset": false
}
```

* `signature` - string. Length 1 - 32.
* `sms_password` - string. Length 1 - 32.
* `reset` - boolean.

**`phonebook_gt300`**

```json
{
  "type": "phonebook_gt300",
  "capacity": 20,
  "items": [
    {
      "name": "Karl",
      "phone": "555469874"
    }
  ]
}
```

* `items` - array of contacts.
  * `name` - string. Contact name.
  * `phone` - string. Phone number in the international format without "+" sign.

**`phonebook_pt100`**

```json
{
  "type": "phonebook_pt100",
  "capacity": 3,
  "items": [
    {
      "name": "Karl",
      "phone": "555469874"
    }
  ]
}
```

* `items` - array of contacts.
  * `name` - string. Contact name.
  * `phone` - string. Phone number in the international format without "+" sign.

**`pwr_off_key`**

```json
{
  "type": "pwr_off_key",
  "mode": "enable"
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.

**`scat_mayak_bt_control`**

```json
{
  "type": "scat_mayak_bt_control",
  "function": "bt_disable",
  "bt_state": true
}
```

* `function` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `bt_disable` | `bt_enable` | `bt_clear` | `bt_write`.
* `bt_state` - boolean.

**`sos_key`**

```json
{
  "type": "sos_key",
  "mode": "report",
  "phone": "55548875236"
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `report` | `call_report`.
* `phone` - string. SOS phone to call. Phone number in the international format without "+" sign.

**`starcom_impact`**

```json
{
  "type": "starcom_impact",
  "strong_duration": 12,
  "strong_force": 4,
  "strong_impact_enabled": true,
  "weak_duration": 9,
  "weak_force": 6,
  "weak_impact_enabled": true
}
```

* `strong_duration` - int. Required impact duration to trigger strong impact event. Each unit equals 2.5 milliseconds. Can be 0 - 14.
* `strong_force` - int. Required impact force triggering strong impact event. Each unit equals about 1.1g. Can be 1 - 7.
* `strong_impact_enabled` - boolean.
* `weak_duration` - int. Required impact duration to trigger weak impact event. Each unit equals 2.5 milliseconds. Can be 0 - 14.
* `weak_force` - int. Required impact force triggering weak impact event. Each unit equals about 1.1g. Can be 1 - 7.
* `weak_impact_enabled` - boolean.

**`tacho_company_card`**

```json
{
  "type": "tacho_company_card",
  "company_card_number": "A2332BF23EC3245A"
}
```

* `company_card_number` - string. 16 HEX digits (0-9A-F).

**`tacho_remote_download`**

```json
{
  "type": "tacho_remote_download",
  "company_card_number": "A2332BF23EC3245A",
  "vu_download_interval": 10,
  "card_download_interval": 2
}
```

* `company_card_number` - string. 16 HEX digits (0-9A-F).
* `vu_download_interval` - int. Min = 0.
* `card_download_interval` - int. Min = 0.

**`teltonika_tacho_request`**

```json
{
  "type": "teltonika_tacho_request",
  "data_type": "activities",
  "activities_start_time": "2020-09-01",
  "activities_end_time": "2020-09-16"
}
```

* `data_type` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `overview` | `activities` | "eventsAndFaults" | "detailedSpeed" | "technicalData" | "card1Download" | "card2Download".
* `activities_start_time` - string date. Format = "YYYY-MM-DD", not null only if `data_type` = `activities`.
* `activities_end_time` - string date. Format = "YYYY-MM-DD", not null only if `data_type` = `activities`.

**`temporary_digital_password`**

```json
{
  "type": "temporary_digital_password",
  "password": "231578",
  "duration_in_min": 17
}
```

* `password` - string. 6 digits.
* `duration_in_min` - int. Can be 10 - 255.

**`time_shift`**

```json
{
  "type": "time_shift",
  "offset": 3.0
}
```

* `offset` - double. Can be -24.0 - 24.0 hours.

**`tow_detection_ql`**

```json
{
  "type": "tow_detection_ql",
  "mode": "enable",
  "engine_off_to_tow": 300,
  "fake_tow_delay": 300,
  "tow_interval": 12000,
  "rest_duration": 90,
  "motion_duration": 8300,
  "motion_threshold": 3
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `engine_off_to_tow` - int. A time parameter to judge whether the device considered towed after the engine off. If the motion sensor doesn't detect stillness within the specified time after the engine off the device is being towed. Can be 0 - 900 seconds.
* `fake_tow_delay` - int. After the engine off and stillness detected, if motion sensor detects moving again, the device turns into a state called fake tow. If the device keeps in fake tow after a period defined by this parameter, it is considered towed. Can be 0 - 600 seconds.
* `tow_interval` - int. The period to send alarm messages. Can be 0 - 86400 seconds.
* `rest_duration` - int. A time parameter to make sure the device enters stillness status, i.e. the status of the device will be changed to stillness if the motion sensor detects stillness and maintains for a period defined by this parameter. Can be 0 - 3825 seconds, step 15.
* `motion_duration` - int. A time parameter to make sure the device enters motion status. Can be 0 - 9900 milliseconds, step 100.
* `motion_threshold` - int. The threshold for the motion sensor to measure whether the device is moving. Can be 2 - 9.

**`tow_detection_ql2`**

```json
{
  "type": "tow_detection_ql2",
  "mode": "enable",
  "engine_off_to_tow": 300,
  "fake_tow_delay": 300,
  "tow_interval": 12000,
  "rest_duration": 90,
  "motion_duration": 400,
  "motion_threshold": 3
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `engine_off_to_tow` - int. A time parameter to judge whether the device considered towed after the engine off. If the motion sensor doesn't detect stillness within the specified time after the engine off the device is being towed. Can be 0 - 900 seconds.
* `fake_tow_delay` - int. After the engine off and stillness detected, if motion sensor detects moving again, the device turns into a state called fake tow. If the device keeps in fake tow after a period defined by this parameter, it is considered towed. Can be 0 - 600 seconds.
* `tow_interval` - int. The period to send alarm messages. Can be 0 - 86400 seconds.
* `rest_duration` - int. A time parameter to make sure the device enters stillness status, i.e. the status of the device will be changed to stillness if the motion sensor detects stillness and maintains for a period defined by this parameter. Can be 0 - 3825 seconds, step 15.
* `motion_duration` - int. A time parameter to make sure the device enters motion status. Can be 100 - 1000 milliseconds, step 100.
* `motion_threshold` - int. The threshold for the motion sensor to measure whether the device is moving. Can be 2 - 9.

**`tow_detection_telfm`**

```json
{
  "type": "tow_detection_telfm",
  "mode": "enable",
  "activation_timeout": 5,
  "threshold": 0.30
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `enable` | `disable`.
* `activation_timeout` - int. Can be 0 - 65535 minutes.
* `threshold` - double. Can be 0.10 - 5.00.

**`video_stream_howen`**

```json
{
  "type": "video_stream_howen"
}
```

**`virtual_ign_ql`**

```json
{
  "type": "virtual_ign_ql",
  "mode": "motion_sensor",
  "ign_on_voltage": 12000,
  "rest_duration_to_off": 120,
  "motion_duration_to_on": 75
}
```

* `mode` - [enum](/docs/navixy-api/general/api-conventions.md#data-types). Can be `disabled` | `power_voltage` | `motion_sensor`.
* `ign_on_voltage` - int. Can be 250 - 28000.
* `rest_duration_to_off` - int. A time parameter to make sure the device enters stillness status, i.e. the status of the device will be changed to stillness if the motion sensor detects stillness and maintains for a period of time defined by this parameter. Can be 1 - 255.
* `motion_duration_to_on` - A time parameter to make sure the device enters motion status. Can be 1 - 255.

**`no_movement_alarm`**

```json
{
  "type": "no_movement_alarm",
  "enabled": true,
  "timeout": 300,
  "pre_alarm_duration": 120
}
```

* `timeout` - int. Can be 30 - 65500. A time parameter when the device doesn't move.
* `pre_alarm_duration` - int. Can be 0 - 65500. A time parameter when the device continues not to move after timeout.


---

# 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/user-api/resources/tracking/tracker/settings/special.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.