Delete a Subscription

Delete a subscription:
POST /subscriptions/actions/delete

Remove a subscription from a ThingSpace account.

See also:
Create a subscription
Update a subscription
Query subscriptions

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.