# Delete Destination Priority

## Overview

This method allows you to remove destination priorities for phone numbers.

## Authentication

{% hint style="info" %}
Authentication is done by passing your TSG Global API key via the Authorization header in the format "Authorization: Bearer \<api\_key>"
{% endhint %}

## Method

## Delete a destination priority associated with a phone number.

<mark style="color:red;">`DELETE`</mark> `https://api-service.tsgglobal.world/v1/did/priority`

#### Path Parameters

| Name                                       | Type   | Description                         |
| ------------------------------------------ | ------ | ----------------------------------- |
| did<mark style="color:red;">\*</mark>      | String | The phone number (e.g. 12022011234) |
| priority<mark style="color:red;">\*</mark> | String | 1-3 in order of preferred priority. |

## Example POST

```
curl -n https://api-service.tsgglobal.world/v1/did/priority -XDELETE -H "Authorization: Bearer <api_key>" \
-H "Content-Type: application/json" -d '{
  "did": "12003004000",
  "priority": 2
}'
```

## **Error Codes**

* `-1000` Invalid or Blank API Key
* `-1003` Invalid or No DID Provided
* `-1004` Invalid or No Priority Provided
* `-1007` Priority Does NOT Exists, Delete an already created priority.
* `-1008` Deleted Priority from Routing.
* `-1010` Can not Delete Priority 1, Please Submit a DID cancel request.

{% hint style="info" %}
**Good to know:** message scheduling can be specified for up to 2 years in advance. We guarantee up to the minute accuracy.
{% endhint %}