Set new settings values
Decommission notice
Purpose
This endpoint is used to change privacy settings.
Request data
HTTPS method: POST
- Constants and parameters enclosed in curly brackets { } must be replaced with their values.
- Please see the following Request parameters section with the required and optional parameters tables for these values. The generic URL format is as follows.
URL request format
https://{baseURL}/geofencing/{versionNumber}/settings?key={Your_API_Key}&adminKey={Your_Admin_Key}curl command request format
curl -XPOST "Content-type: application/json" -d'{ "consentForStoringObjectsPositionsHistory": true/false, "consentForStoringTransitionsHistory": true/false }''https://{baseURL}/geofencing/{versionNumber}/settings?key={Your_API_Key}&adminKey={Your_Admin_Key}'POST request body format
{ "consentForStoringObjectsPositionsHistory": true/false, "consentForStoringTransitionsHistory": true/false}Request parameters
The following table describes the parameters that can be used in a request.
- Required parameters must be used or the call will fail.
- Optional parameters may be used.
- The order of request parameters is not important.
Note: There are no optional parameters in this endpoint.
Required parameters | Description |
|---|---|
| The base URL for calling the API. |
| Service version. |
| An API Key valid for the requested service. |
| An Admin Key valid for the provided API Key. |
Response data
Response body
The following JSON code block demonstrates a successful response from the API server.
{ "consentForStoringObjectsPositionsHistory": true/false, "consentForStoringTransitionsHistory": true/false}Response fields
The following table describes all of the fields that can appear in a response.
Primary fields | Description |
|---|---|
| Setting that allows the service to store sensitive, historical objects data in the Geofencing service. This field is shared between the Geofencing and Location History APIs. |
| Setting that allows the service to store sensitive, historical data in the Geofencing service. |
Response codes
Code | Meaning & possible causes |
|---|---|
| OK |
| Bad Request: No setting has been provided. |
| Forbidden:
|
Example
Set new setting values.
HTML Method: POST
https://api.tomtom.com/geofencing/1/settings?key={Your_API_Key}&adminKey={Your_Admin_Key}POST request body example
{ "consentForStoringObjectsPositionsHistory": true, "consentForStoringTransitionsHistory": false}Response body example
{ "consentForStoringObjectsPositionsHistory": true, "consentForStoringTransitionsHistory": false}