Sign in
Sign up
Reference Visual Designer Tutorials
    • API Overview
      • API Endpoint
      • Authentication
      • Requests
      • Responses
      • Paging
      • Reason Codes Dictionary
    • Management APIs
      • Accounts
        • Retrieve Account
        • Create Account
        • Update Account
        • Delete Account
        • Account Roles
      • Tags
        • Create Tag
        • Update Tag
        • Get Tag list
        • Retrieve Tag
        • Delete Tag
      • Profiles
        • Create Profile
        • Update Profile
        • Unlink a Profile from an Account
        • Link a Profile to an Organization
        • Unlink a Profile to an Organization
        • Get Profiles List
        • Paging
        • Filtering & Profile Document Inclusion
        • Get Profile Details
        • Get Profile Relationship
        • Get Account Relationship
        • Delete Profile
      • Applications
      • Clients
        • Create a Client
        • Delete a Client
        • Change Client’s Password
        • Get a List of Available Clients
      • Incoming Phone Numbers
        • IncomingPhoneNumber Instance Resource
        • IncomingPhoneNumbers List Resource
        • Local IncomingPhoneNumber Factory Resource
        • Toll-Free IncomingPhoneNumber Factory Resource
        • Mobile IncomingPhoneNumber Factory Resource
        • Attach a phone number to an application
        • Delete a phone number
        • List of Phone Numbers
        • Incoming Phone Number Regex Support
      • Notifications
      • Usage Records
      • Audit Logs
    • Voice APIs
      • Calls
        • Call List Resource URI
        • Making a Call
        • Modifying Live Calls
        • Examples
        • List Filter
        • Paging Information
      • Outgoing Caller ID
      • Conference Management
        • Supported Operations
        • Conference List Resource URI
      • Conference Participants Management
        • Participants List Resource URI
      • Recordings
      • SIP Refer Support
    • SMS APIs
      • Outgoing Caller ID
      • Messages
        • Send SMS
        • Get SMS List
        • Get single SMS Information
        • SMS Attributes
      • Email
    • Turnkey Apps APIs
      • Microsoft Teams
        • Business Customer
        • Manage Mappings
        • Bot details
        • Messages
      • Smart 2FA
        • Sending One-Time Passwords
        • Verifying One-Time Passwords
        • Cancel One-Time Passwords
        • Session Detail Record (SDR)
        • Get list of One-Time Passwords
        • Get a Single One-Time Password
        • Usage Record One-Time Passwords
      • Message Exchange for Cisco UC-One
        • Create Operation
        • Read Operation
        • Update Operation
        • Delete Operation
        • Error Codes
      • Message Exchange for Cisco Webex Teams
        • Create Operation
        • Read Operation
        • Update Operation
        • Delete Operation
      • Call Queuing
        • Create Queue
        • Queue RCML
        • Enqueue RCML
      • Auto Attendant
        • Enterprise
        • User
        • Announcement
        • Auto Attendant System
        • Menu
        • Schedule
        • Phone Number
        • HMAC Key
      • Number Masking
      • Task Router
        • Create Enterprise
        • Get a List of Enterprises
        • Get Single Enterprise
        • Delete Enterprise
        • Create User
        • Get a List of Users
        • Get a Single User
        • Update User
        • Delete user
      • Campaign Manager
        • Business Customers
          • Business Customer Status
          • Create Business Customer
          • Update Business Customer
          • Delete Business Customer
          • Get List of Business Customers
          • Get Single Business Customer
        • User
          • User Role and Status
          • Create User
          • Update User
          • Delete User
        • Get List of Users
        • Get Single User
        • Manage Credits
        • Create Credit
          • Get List of Credits
          • Get Single Credit
        • Campaign
          • Campaign Status
          • Get List of Campaigns
          • Get Single Campaign
    • RCML
      • Overview
        • Interacting with Your Application
        • RCML Verbs
      • Dial
        • Client
        • Conference
        • Number
        • SIP
      • Email
      • Gather
      • Say
        • SSML Reference
      • Play
      • SMS
      • Hangup
      • Pause
      • Redirect
      • Record
      • Reject
docs 1.0
  • docs
    • 1.0
  • docs
  • CSP:Turnkey Apps APIs
  • CSP:Message Exchange for Cisco UC-One
  • CSP:Delete Operation

Delete Operation

Delete Enterprise

Delete Enterprise will delete the underlying Enterprise if it doesn’t have any corresponding mapping.

Base Resource URI

https://your_custom_domain.com

Delete Enterprise Resource URI

/messageexchange/enterprise/{EnterpriseId}

Supported Operations

HTTP DELETE: Delete Enterprise

Request Parameters

Parameter

Description

EnterpriseId

Enterprise SID that was generated by calling create Enterprise API

Response Body

Response Body will carry Code, corresponding message and data of Enterprise if it was successfully deleted ,HTTP response will be 200 OK.

Code

Description

code

Sub-error code for response

message

Message describing error if error occured or success message

data

Enterprise data as explained in Enterprise Data Parameter

Response Parameters

Create Enterprise API will return Error Code and corresponding HTTP Error as mentioned in Common Response Error Code. In addition below are the Error that it can return

Error Code

HTTP Status

Error Message

Description

Category

482

409

Enterprise has mappings

Delete Enterprise API is called for enterprise name that has Mappings associated.

Update Enterprise

467

409

Enterprise not found

Enterprise is not found.

Create Mapping, Update Mapping, Update Enterprise, Search Enterprise, Delete Enterprise

Example:

From the bash terminal you can run the command below:

curl -X DELETE \
https://cloud.restcomm.com/messageexchange/enterprise/EN263d95d2bafa4e4a9e6a5563851cd283 \
--user  ' \{your_account_SID}:\{your_account_token}' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \

If delete of Enterprise is successful, below is the response returned:

{
        "code":200,
{
    "data": {
        "sid": "EN263d95d2bafa4e4a9e6a5563851cd283",
        "dateUpdated": "2019-10-11T11:12:24+0000",
        "dateCreated": "2019-10-11T11:11:01+0000",
        "accountSid": "ACa91f3a070d55122d9ec0069b0be27758",
        "accountEmail": "subhahu.reddy@telestax.com",
        "uri": "/messageexchange/enterprise/search/EN263d95d2bafa4e4a9e6a5563851cd283",
        "name": "Kohl",
        "mappingsCount": 0
    },
    "code": 200,
    "message": "OK"
}

If delete fails, below response is returned with corresponding HTTP Error Code

{
  "code":482,
  "message":"Enterprise has mappings",
   “data”:
{
  “sid":"MXEb6eb071d21124dbab20b095c25f1274f",
  “name” :”Kohl”
}
}

Delete MX Mappings

Delete MX Mapping will delete mapping between Jabber Address and SMS enabled number.

Base Resource URI

https://your_custom_domain.com

Delete MX Mappings Resource URI

/messageexchange/mappings/{mappingId}

Supported Operations

HTTP DELETE: Delete MX users and SMS enabled numbers mappings

Request Parameters

Parameter

Description

mappingId

Unique MX vs SMS enabled number mapping id that was generated by calling Add Mapping API

Response Body

Response Body will carry Code, corresponding message and data of Mapping that is deleted .if it was successfully deleted, HTTP response will be 200 OK.

Code

Description

code

Sub-error code for response

message

Message describing error if error occured or success message

data

Mapping data as explained in Mapping Data Parameter

Response Parameters

Delete MX mapping API will return Error Code and corresponding HTTP Error as mentioned in Common Response Error Code

Error Code

HTTP Status

Error Message

Description

Category

478

409

Mapping not found

MappingId is not found for give Organisation

Update Mapping, Delete Mapping, Search Mapping

Example:

From the bash terminal you can run the command below:

curl -X DELETE \
  https://cloud.restcomm.com/messageexchange/mappings/XM00009e272d9047dc858549485b0d0e1f \
--user  ' \{your_account_SID}:\{your_account_token}' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \

If delete mapping is successful, below is the response returned:

{
    "data": {
        "sid": "XM04f7959a96c34814ba163a4f5c8c7fc1",
        "dateUpdated": "2019-10-11T11:19:55+0000",
        "dateCreated": "2019-10-11T11:16:03+0000",
        "accountSid": "ACa91f3a070d55122d9ec0069b0be27758",
        "accountEmail": "subhahu.reddy@telestax.com",
        "uri": "/messageexchange/mappings/search/XM04f7959a96c34814ba163a4f5c8c7fc1",
        "jabberAddress": "jane.doe@yourcompany.com",
        "externalAddress": "157133169432",
        "enterpriseSid": "EN38d48bc7dea7470090c8fc809a69a620",
        "name": "Amit Bhayani New",
        "enterpriseName": "testing"
    },
    "code": 200,
    "message": "OK"
}

If delete of mapping fails, corresponding error code and message will be returned with HTTP Error code.

{
    "errorCode": "478",
    "message": "Mapping not found",
    "data": {
        "sid": "XM04f7959a96c3814ba163a4f5c8c7fc1"
    }
}

Delete Domain

Delete Domain will delete the underlying Domain

Base Resource URI

https://your_custom_domain.com

Delete Domains Resource URI

/messageexchange/domains/{domainId}

Supported Operations

HTTP DELETE: Delete Domain

Request Parameters

Parameter

Description

domainId

Domain Id that was generated by calling create Domain API

Response Body

Response Body will carry Code, corresponding message and data of domain that is deleted.if it was successfully deleted, HTTP response will be 200 OK.

Code

Description

code

Sub-error code for response

message

Message describing error if error occured or success message

data

domain data as explained in the Domain Data Parameter

Response Parameters

Delete Domain API will return Error Code and corresponding HTTP Error as mentioned in Common Response Error Code. In addition below are the Error that it can return

Error Code

HTTP Status

Error Message

Description

Category

474

409

Domain Id not found

Domain is not found.

Update Domain, Delete Domain

483

409

Domains assigned to mappings

Delete Domain API is called for Domain that is still used by Mappings

Delete Domain

Example:

From the bash terminal you can run the command below:

curl -X DELETE \
https://cloud.restcomm.com/messageexchange/domains/DO11488d772bab489d9369cae29c8a6803 \
--user  ' \{your_account_SID}:\{your_account_token}' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \

If delete of Domain is successful, below is the response returned:

{
    "data": {
        "sid": "DOe334d1141af84ae6b7e44858d1745609",
        "dateUpdated": "2019-10-11T11:28:17+0000",
        "dateCreated": "2019-10-11T11:25:16+0000",
        "accountSid": "ACa91f3a070d55122d9ec0069b0be27758",
        "accountEmail": "subhahu.reddy@telestax.com",
        "uri": "/messageexchange/domains/search/DOe334d1141af84ae6b7e44858d1745609",
        "name": "mycompanynew.com",
        "certificate": " -----BEGIN CERTIFICATE----------END CERTIFICATE-----",
        "mappingsCount": 0
    },
    "code": 200,
    "message": "OK"
}

If deletion of domain fails, below is the response returned. Exact error code and message will depend on error occurred

{
    "errorCode": "474",
    "message": "Domain Id not found",
    "data": {
        "sid": "DOe334d1141af4ae6b7e44858d1745609"
    }
}

Delete Whitelist IP

Delete Whitelist IP will delete the IP whitelisted

Base Resource URI

https://your_custom_domain.com

Delete Whitelist IP Resource URI

/messageexchange/whitelist/{whitelistId}

Supported Operations

HTTP DELETE: Delete Whitelist IP

Request Parameters

Parameter

Description

whitelistId

Whitelist Id that was generated by calling create Whitelist IP API

Response Body

Response Body will carry Code, corresponding message and data of Whitelist IP if it was successfully deleted. HTTP response will be 200 OK.

Code

Description

code

Sub-error code for response

message

Message describing error if error occured or success message

data

Whitelist IP data as explained in IP Whitelist Data Parameter

Response Parameters

Delete Whitelist IP API will return Error Code and corresponding HTTP Error as mentioned in Common Response Error Code. In addition below are the Error that it can return

Error Code

HTTP Status

Error Message

Description

Category

475

400

Whitelist Id not found

API is called passing Whitelist IP Id that is not present in system

Update Whitelist IP, Delete Whitelist IP

Example

From the bash terminal you can run the command below:

curl -X DELETE \
https://cloud.restcomm.com/messageexchange/whitelist/WL9fc6143123d048579f7d5b5d76572e1d \
--user  ' \{your_account_SID}:\{your_account_token}' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \

If delete of Whitelist IP is successful, below is the response returned:

{
    "data": {
        "sid": "WL98fbe024c1c34794a4034646db503627",
        "dateUpdated": "2019-10-11T11:07:16+0000",
        "dateCreated": "2019-10-11T11:06:35+0000",
        "accountSid": "ACa91f3a070d55122d9ec0069b0be27758",
        "accountEmail": "subhahu.reddy@telestax.com",
        "uri": "/messageexchange/whitelist/search/WL98fbe024c1c34794a4034646db503627",
        "ipAddress": "4.3.2.1"
    },
    "code": 200,
    "message": "OK"
}

If delete of whitelist IP fails, below is the response returned. Exact error code and message will depend on error occurred

{
    "errorCode": "474",
    "message": "Domain Id not found",
    "data": {
        "sid": "DOe334d1141af4ae6be44858d1745609"
    }
}
Contact Us

+1 (650) 263 6146

SALES

SUPPORT

GENERAL

Follow Us

Turnkey Applications

SMART 2FA

MESSAGE EXCHANGE

CISCO WEBEX

CALL QUEUE

Learn

BLOG

TERMS AND CONDITIONS

Additional Links

ABOUT

FAQ'S

PRIVACY POLICY

CONTACT