Sorry, you need to enable JavaScript to visit this website.
Geofencing API
Get your key

Update alert rule partially

 

Service version: 1
Last edit: 2020.09.30

On this page

Purpose

This endpoint is used to partially update an Alert Rule.

Request data

HTTPS method: PATCH

URL format

For ease of viewing and identification:

  • Required constants and parameters are shown in bold text.
  • Optional parameters are shown in plain text.
https://baseURL/geofencing/versionNumber/alerts/rules/ruleId?key=Your_API_Key&adminKey=Your_Admin_Key

curl command

curl -XPATCH -d '{
  "enabled": true
}'
'https://baseURL/geofencing/versionNumber/alerts/rules/ruleId?key=Your_API_Key&adminKey=Your_Admin_Key'

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.
  • If an optional parameter has a default value, it is described in the table.
  • The order of Request parameters is not important.
Required parameters
Parameter Description
baseURL
string		 The base URL for calling the API.
Value: api.tomtom.com
versionNumber
string		 Service version.
Value: 1
ruleId
string		 The UUID of the Alert Rule.
key
string		 An API Key valid for the requested service.
Value: Your valid API Key.
adminKey
string		 An Admin Key valid for the provided API Key.
Value: Your valid Admin Key.
Optional parameters
Note: There are no optional parameters in this endpoint.

PATCH Request body

{
  "enabled": true
}

Request fields

The following table describes the fields that can be used in a Request body.

Primary fields
Field Description
enabled
boolean		 The Boolean value that says if an Alert Rule is enabled or not.
Values:
  • true: An Alert is enabled.
  • false: An Alert is disabled.
Default value: The previous value.

▲ Return to top

Response data

Response body

{
  "id": "The id of the alert rule",
  "name": "The name of the alert rule",
  "object": "The id of the object",
  "project": "The id of the project",
  "fence": "The id of the fence",
  "alertType": "Type of the alert",
  "alertRuleConstraints": {
    "key": "value"
  },
  "notificationGroup": "The id of the notification group",
  "enabled": true
}

Response fields

The following table describes all of the fields that can appear in a Response.

Primary fields
Field Description
id
string		 The UUID of the Alert Rule.
name
string		 The name of the Alert Rule.
object
string		 The UUID of the Object or * for any Object in the Configuration.
project
string		 The UUID of the Project or * for any Project in the Configuration.
fence
string		 The UUID of the Fence or * for any Fence in the Configuration.
alertType
string		 The type of the Alert Rule.
Possible values:
  • "TRANSITION": When an Object entered or exited Fence.
  • "DWELL": When an Object stays too long inside a Fence.
  • "OBJECT_COUNT": When the maximum number of Objects in a Fence is exceeded.
alertRuleConstraints{}
object		 Contains information about a specific Alert Rule.
notificationGroup
string		 The UUID of the owned group in the Notification Service to send the Alert Rule.
enabled
boolean		 The Boolean value that says if an Alert Rule is enabled or not.
Values:
  • true - An Alert is enabled
  • false - An Alert is disabled
alertRuleConstraints{} object
Field Description
transitionType
string		 The type of the Transition to Alert.
Possible values:
  • "ENTER": When an Object just entered the Fence.
  • "EXIT": When an Object just exited the Fence.
  • "ALL": When an Object just entered or exited the Fence.
This field exists for the "TRANSITION" Alert type.
maxDwellTime
integer		 Maximum time (in seconds) an Object can stay inside a Fence before an Alert is raised.
This field exists for the "DWELL" Alert type.
maxObjectCount
integer		 Maximum number of Ojects that can be present in a Fence at one time before an Alert is raised.
This field exists for the "OBJECT_COUNT" Alert type.

HTTP Response codes

Code Meaning and possible causes
200 OK
400 Bad request:
  • Field "enabled" is not provided.
403 Forbidden:
  • Provided Admin Key is invalid.
  • Admin Key is missing.

▲ Return to top

Examples

Example: Partially update the Alert Rule.

Request format

https://api.tomtom.com/geofencing/1/alerts/rules/bf40406b-1d8d-4218-bcf2-e67b83063d02?key=nQRhDX5saL2KM0dIzEfeX2lcxWk9ktT2qXDZpwCr&adminKey=QekKaqqCHBpFLPCeViVS

PATCH body format

{
  "enabled": false
}

Response body

{
  "id": "bf40406b-1d8d-4218-bcf2-e67b83063d02",
  "name": "Airport transition alert",
  "project": "47b10143-0b43-4803-a931-98cb1e595520",
  "fence": "*",
  "object": "fc94720b-23cd-4ddf-a560-00f8518e43c9",
  "alertType": "TRANSITION",
  "alertRuleConstraints": {
    "transitionType": "ALL"
  },
  "notificationGroup": "358a3348-26d6-4d9d-8d5a-c3de41b26f63",
  "enabled": false
}

▲ Return to top