Device Management

Sets a new service plan for one or more devices.

PUT
/m2m/v1/devices/actions/plan

Changes the service plan for one or more devices.

Authorization

thingspace_oauth VZ-M2M-Token
AuthorizationBearer <token>

This is the ThingSpace token, from Credentials and Tokens is used

In: header

VZ-M2M-Token<token>

M2M Session Token (How to generate an M2M session token?)

In: header

Request Body

application/json

Request to change device service plan.

Request to change device service plan.

servicePlan*string

The service plan code that you want to assign to all specified devices.

accountName?string

The name of a billing account.

currentServicePlan?string

The name of a service plan, if you want to only include devices that have that service plan.

customFields?array<>

Custom field names and values, if you want to only include devices that have matching values.

devices?array<>

A list of the devices that you want to change, specified by device identifier.

groupName?string

The name of a device group, if you want to restore service for all devices in that group.

carrierIpPoolName?string
Match^[A-Za-z0-9]{3,32}$
Length3 <= length <= 32
takeEffect?string
Formatdate-time

Response Body

application/json

application/json

curl -X PUT "https://example.com/m2m/v1/devices/actions/plan" \  -H "Content-Type: application/json" \  -d '{    "servicePlan": "Tablet5GB",    "devices": [      {        "deviceIds": [          {            "id": "A100003685E561",            "kind": "meid"          }        ]      }    ],    "carrierIpPoolName": "IPPool"  }'
{  "requestId": "c8de7c1d-59b9-4cf3-b969-db76cb2ce509"}