Deregister A Callback Listener

Deregister a callback listener:
DELETE /callbacks/{callbackType}/{code}

Stops the ThingSpace Platform from sending callback messages for the specified short code and callback type.

Contents

See also:
About SMS API Callbacks
List Callback Listeners
Register a Callback Listener

Request Components

HTTP Request

DELETE https://thingspace.verizon.com/api/messaging/v1/callbacks/{callbackType}/{code}

Resource and Query Parameters

You must include the code and callback type in the path.

Parameter Name Data Type Description
callbackType
required
string The type of the callback service type that you want to stop. Valid values are:
  • Default
  • SMS_DeliveryReport
  • SMS_MobileOriginatedMessage
  • OptIn
  • OptOut
code
required
string The long code for the service for which you want to stop receiving callbacks.

Header Parameters

The request header must contain a current ThingSpace authorization bearer token.

Parameter Name Data Type Description
Authorization
required
string HTTP Authorization request header.

Request Body

None.

Success Responses

Status 200

Parameter Name Data Type Description
success boolean True for status 200 response.

Example Success Response

{
  "success": true
}

Failure Responses

Status 400

All error messages are returned in this format:

{
  "error": "The type of error, such as INVALID_REQUEST.",
  "error_description": "Additional error information.",
  "error_url": "Optional URI with more information about the error."
}

The error_url field will not be present if there is no URI for more information.

Error codes and messages are listed on the Status Codes page, along with explanations and suggestions for corrective actions.

Try It Out!