Delete a Callback Listener

DELETE /callbacks

Stops ThingSpace from sending callback messages for the specified account and listener name.

Contents

See also:

Request Components

A vz-m2m-token is required to use these APIs. To obtain a token, please visit Getting Started to get a token.

HTTP Request

DELETE https://thingspace.verizon.com/api/hyper-precise/v1/callbacks?accountNumber={accountNumber}&name={name}

Request Parameters

Parameter Data Type Description
accountNumber
required
string A unique identifier for an account..
name
required
string The name of the callback listener that will be deleted.

Request Body

Example request:

curl -X 'DELETE' \
  'https://thingspace.verizon.com/api/hyper-precise/v1/callbacks?accountNumber={accountName}&name={name}' \
  -H 'accept: application/json' \
  -H 'VZ-M2M-Token: {token}'

Success Responses

Status 200

A successful request returns a responseCode and/or a message indicating success or failure of the request

Example response:

{
  "responseCode": "string",
  "message": "string"
}

Response Parameters

Parameter Data Type Description
responseCode string An enumerated string with one of the following values - INVALID_ACCESS, INVALID_PARAMETER, INTERNAL_ERROR, SUCCESS.
message string More details about the responseCode received.

Failure Responses

Code and Meaning Format
400 - Bad Request.
{
  "errorCode": "INVALID_PARAMETER",
  "errorMessage": "Device Not Found, Request will be queued"
}
401 - Unauthorized request. Access token is missing or invalid.
{
  "errorCode": "INVALID_ACCESS",
  "errorMessage": "The access policy denied the resource operation for this user"
}
403 - Forbidden request.
{
  "errorCode": "INVALID_PARAMETER",
  "errorMessage": "Device Not Certified"
}
404 - Bad request. Not found.
{
  "errorCode": "INVALID_PARAMETER",
  "errorMessage": "Device inactive"
}
409 - Bad request. Conflict state.
{
  "errorCode": "INVALID_PARAMETER",
  "errorMessage": "Service Not Purchased"
}

500 - Internal Server Error.

{
  "errorCode": "INTERNAL_ERROR",
  "errorMessage": "Device is active in several accounts"
}