Developer

Delete transition alert rule

Service version: 1
Last edit: 2020.11.16
Deprecated

Deprecation notice

November 6, 2020

  • The "Delete transition alert rule" endpoint has been deprecated.

  • This endpoint has been replaced with the generic endpoint to handle all types of Alert Rules: Delete alert rule.

  • This endpoint will be withdrawn following a 12 month deprecation period.

  • The planned withdrawal date is December 1, 2021.

  • Following withdrawal, requests to this endpoint may receive an HTTP 404 error in response.

  • More details are available at the TomTom deprecation policy page.

Purpose

This endpoint is used to delete a Transition Alert Rule.

Request data

HTTPS method: DELETE

  • 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 their values. The generic request format is as follows.

URL format

delete
URL request example
https://{baseURL}/geofencing/{versionNumber}/alerts/transitions/{ruleId}?key={Your_API_Key}&adminKey={Your_Admin_Key}

curl command format

delete
Request curl command example
curl -XDELETE 'https://{baseURL}/geofencing/{versionNumber}/alerts/transitions/{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.
  • The order of request parameters is not important.

Note: There are no optional parameters in this endpoint.

Required parameters

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.

Response data

Response body

Response body - JSON
1{
2  "id": "The id of the alert rule",
3  "name": "The name of the alert rule",
4  "object": "The id of the object",
5  "project": "The id of the project",
6  "fence": "The id of the fence",
7  "transitionType": "ALL",
8  "notificationGroup": "The id of the notification group",
9  "enabled": true
10}

Response fields

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

Primary fields

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 configuration.

project
string

The UUID of the project or * for any project in configuration.

fence
string

The UUID of the fence or * for any fence in configuration.

transitionType
string

The type of the transition to alert.
Possible values:

  • "ENTER" - when object just entered the fence

  • "EXIT" - when object just exited the fence

  • "ALL" - when object just entered or exited the fence

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 - alert is enabled

  • false - alert is disabled

Response codes

Code

Meaning and possible causes

200

Deleted

403

Forbidden:

  • The provided Admin Key is invalid.
  • The Admin Key is missing.

404

Not found: Alert with the provided id does not exist.

Example

Delete a specific Transition Alert Rule.

Request format

delete
URL request example
https://api.tomtom.com/geofencing/1/alerts/transitions/1f9e811f-867b-4d4d-aed9-7d8266fac0ae?key=PJD7y0G5AFj9Jiok6F0tIK16NiWYotb3&adminKey=FTZYUH7KxeNQohCuRvK8

Response body

Response body - JSON
1{
2  "id": "1f9e811f-867b-4d4d-aed9-7d8266fac0ae",
3  "name": "Airport transition alert",
4  "object": "*",
5  "project": "ab550513-7026-4c98-9ff7-a930d70b66f8",
6  "fence": "0b16633b-7b2b-4fd6-a834-f36c2250ab6",
7  "transitionType": "ALL",
8  "notificationGroup": "8e34613a-2324-4749-ac9d-25bf7a91d218",
9  "enabled": true
10}