Delete a Subscription:

`POST /subscriptions/actions/delete`

Remove a subscription from a ThingSpace account.

Uses and Requirements

Request Components

HTTP Request

POST https://thingspace.verizon.com/api/cc/v1/subscriptions/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 subscription 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	The ID of the subscription to delete, in the format `{"id": "dd1682d3-2d80-cefc-f3ee-25154800beff"}`.

Example Request

curl -X POST https://thingspace.verizon.com/api/cc/v1/subscriptions/actions/delete \
  -H 'Authorization: Bearer 18261b8341d07fc32c760c2a5acaad27' \
  -H 'VZ-M2M-Token: 885b3ba5-b149-4fe8-91c5-51efb1b7462a' \
  -H 'Content-Type: application/json' \
  -d '{
    "accountidentifier": {"billingaccountid":"1223334444-00001"},
    "resourceidentifier": {"id": "f8b112df-739c-6236-f059-106c67bafd99"}
}'

Success Responses

Status 204

Subscription 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.