Remove Devices From Exclusion List

Remove devices from the exclusion list:

DELETE /consents

Removes devices from the exclusion list so that they can be located with a POST /locations or a POST /locationreports request.


See also:
Exclude Devices
Get a list of excluded devices

Uses and Requirements

You can remove up to 2,000 devices per request.

Request Components

HTTP Request


Resource Path and Query Parameters


Header Parameters

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

Parameter Name Data Type Description
string HTTP Authorization bearer token.
string A valid session token returned by POST /api/m2m/v1/session/login.
string Must be application/json.

Request Body

The request body gives the account name and list of devices to be removed from the exclusion list.

Parameter Name Data Type Description
string The name of a billing account, which is usually in the format of 10 digits, a hyphen, and then five more digits. Must include any leading zeros.
array of strings A list of one hardware identifier for each device that you want to remove from the exclusion list. You can use IMEI, MEID, or ESN.

Success Responses

Status 200

A response to a successful request contains a single Boolean value:

  "success": true

Failure Responses

Status 400

All error messages are returned in this format:

  "errorCode": "The type of error, such as INVALID_REQUEST.",
  "errorMessage": "Additional error information."

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

Try It Out!