Premium APIsSoftware ManagementSoftware Management V3API Reference Pages V3

Deregister a Callback Listener

DELETE /callbacks/{accountName}

Deregisters the callback endpoint and stops ThingSpace from sending FOTA callback messages for the specified account.

HTTP Request

DELETE https://thingspace.verizon.com/api/fota/v3/callbacks/{accountName}

Header Parameters

The request header must contain a current ThingSpace authorization token, set the content to "JSON" and a current VZ-M2M-session token.

Parameter NameData TypeDescription
Authorization (required)stringHTTP Authorization request header containing a valid Bearer token: Authorization: Bearer {token}
VZ-M2M-Token (required)stringA valid session token returned by a Connectivity Management POST /session/login request.
Content-Type (required)stringMust be application/json.

Request Parameters

The accountName must be included in the path.

Parameter NameData TypeDescription
accountName (required)stringThe name of the billing account that is registered to receive callback messages. An account name is numeric, and must include any leading zeros.

Request Body

None.

Success Responses

Status 200 A response to a successful request contains a single Boolean value. Example Response:

{
  "success": true
}

Success Parameters

Parameter NameData TypeDescription
successbooleanIf the request to deregister is successful, the response will show true. If the request fails, the response will show false.

Failure Responses

All error messages are returned in this format:

{
  "errorCode": "error code string",
  "errorMessage": "error message string"
}

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

On this page