TSG Global API Documentation
  • Get Started
  • ISO/IEC/SOC Certification
  • Staging Environment Access
  • API Reference
    • Programmable SMS
      • Send an SMS Message
      • Receive an SMS Message
      • Delivery Receipts (DLRs)
      • SMPP
        • Headers
        • Errors
    • Programmable MMS
      • Send an MMS Message
      • Receive an MMS Message
      • Receive DLRs
      • SMTP
    • Phone Numbers
      • Search For New Available Numbers
      • Add Number to Cart
      • Get Reserved Numbers In Cart
      • Remove Reserved Number From Cart
      • Checkout Numbers in Cart
      • Disconnect Number
      • Get Number Information
      • Manage Number for SMS & 10DLC
        • Enable SMS/10DLC on a Number
        • Disable SMS on a Number
        • Update inbound SMS webhook/URI
      • Manage Number for MMS
        • Enable MMS on a Number
        • Disable MMS on a Number
        • Update inbound MMS webhook/URI
      • Manage Number for Voice
        • List Destination Priority
        • Add Destination Priority
        • Update Destination Priority
        • Delete Destination Priority
      • Protect your phone number
        • TextProtect Webhook
      • Toll-free phone numbers - search & ordering
    • Data Services
      • CNAM Lookup
      • Lookup SMS Carrier
    • Reports
      • CDR Records
        • Get Count of CDR Records
        • Get CDR Records
    • Compliance & Identity
      • Business Identity & 10DLC (TNID v1)
      • Toll-Free Verified Sender (Order)
      • Short Code Submission (Order)
  • GraphQL API & Authentication
Powered by GitBook
On this page
  • Overview
  • Authentication
  • Method
  • Delete a destination priority associated with a phone number.
  • Example POST
  • Error Codes

Was this helpful?

  1. API Reference
  2. Phone Numbers
  3. Manage Number for Voice

Delete Destination Priority

Overview

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

Authentication

Authentication is done by passing your TSG Global API key via the Authorization header in the format "Authorization: Bearer <api_key>"

Method

Delete a destination priority associated with a phone number.

DELETE https://api-service.tsgglobal.world/v1/did/priority

Path Parameters

Name
Type
Description

did*

String

The phone number (e.g. 12022011234)

priority*

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.

Good to know: message scheduling can be specified for up to 2 years in advance. We guarantee up to the minute accuracy.

PreviousUpdate Destination PriorityNextProtect your phone number

Last updated 2 years ago

Was this helpful?