Delete a Device

Delete a device:
POST /devices/actions/delete

Remove a device from a ThingSpace account.

Uses and Requirements

Request Components

HTTP Request

POST https://thingspace.verizon.com/api/cc/v1/devices/actions/delete

Resource Path and Query Parameters

None.

Header Parameters

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

Property Name Data Type Description
Authorization
required
string HTTP Authorization request header containing a valid ThingSpace Bearer token.
VZ-M2M-Token
required
string A valid session token returned by a Connectivity Management API POST /session/login request using the account’s UWS credentials.
Content-Type
required
string Must be application/json.

Request Body

The request body identifies the device to delete.

Property Name Data Type Description
accountidentifier
required
JSON object The ID of the authenticating billing account, in the format {"billingaccountid":"1234567890-12345"}.
resourceidentifier
required
JSON object A device ID type and value that identifies the device to delete. Can be any unique device identifier, such as ICCID, ID, or IMEI.

Example Request

Delete a device by specifying the device’s IMEI

curl -X POST https://thingspace.verizon.com/api/cc/v1/devices/actions/delete \
  -H 'Authorization: Bearer b374b9cba5297f31c53d9c64a007aa86' \
  -H 'VZ-M2M-Token: ad87aecf-6d5e-433b-b896-ca39f96720e0' \
  -H 'Content-Type: application/json' \
  -d '{
  "accountidentifier": {"billingaccountid":"1223334444-00001"},
  "resourceidentifier": {"imei": 864508030147223}
}'

Success Responses

Status 204

Device deleted successfully. The response has no body.

Failure Responses

Status 4xx

All error messages are returned in this format:

{
  "error": "error code string",
  "error_description": "error message string",
  "cause": "further explanation"
}

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