Device Management

Changes or removes the costCenterCode value for one or more devices.

PUT
/m2m/v1/devices/costCenter

Changes or removes the CostCenterCode value or customer name and address (Primary Place of Use) 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 update cost center code value for one or more devices.

Request to update cost center code value for one or more devices.

accountName?string

The name of a billing account.

costCenter?string

The new cost center code. Valid values are any string of up to 36 alphanumeric characters, space, dash, exclamation point, and pound sign.

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. Do not include accountName, groupName, customFields, or servicePlan if you use this parameter.

groupName?string

The name of a device group, if you want to only include devices in that group.

primaryPlaceOfUse?

The customer name and the address of the device's primary place of use. These values are applied to all devices in the request.The Primary Place of Use location may affect taxation or have other legal implications. You may want to speak with legal and/or financial advisers before entering values for these fields.

removeCostCenter?boolean

Set to true to remove the cost center code value. This flag takes precedence over a new costCenter value. If this flag is true and costCenter has a value, the cost center code is removed. Do not include this parameter, or set it to false to change the costCenter value.

servicePlan?string

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

Response Body

application/json

application/json

curl -X PUT "https://example.com/m2m/v1/devices/costCenter" \  -H "Content-Type: application/json" \  -d '{    "costCenter": "cc12345",    "devices": [      {        "deviceIds": [          {            "id": "89148000000800139708",            "kind": "iccid"          }        ]      }    ]  }'
{  "requestId": "595f5c44-c31c-4552-8670-020a1545a84d"}