Device Management

Changes the identifier of a 3G or 4G device to match hardware changes made for a line of service.

PUT
/m2m/v1/devices/{serviceType}/actions/deviceId

Changes the identifier of a 3G or 4G device to match hardware changes made for a line of service. Use this request to transfer the line of service and the MDN to new hardware, or to change the MDN.

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

Path Parameters

serviceType*string

Identifier type.

Request Body

application/json

Request to update device id.

Request to update device id.

assignNonGeoMdn?boolean

Set to true to assign a non-Geo MDN and MSISDN, or false to assign an MDN and MSISDN from a specific NPA-NXX.

change4gOption?string

The type of change that you want to make for a 4G device.

deviceIds*array<>

The device that you want to change, specified by a device identifier.

deviceIdsTo?array<>

The new identifier for the device. Required for all change4GOptions except ChangeMSISDN.

npaNxx?string

The NPA NXX (area code and prefix) from which the MDN and MSISDN will be derived when assignNonGeoMDN is false. Specify the 6-digit NPA NXX of the location where the line of service will primarily be used. This API checks to see if a number starting with the NPA NXX is available. If not, this API uses the zipCode parameter, if specified, to assign a number in the area of the line of service. This parameter is required when you change an MDN/MSISDN for a B2B carrier, such as Verizon Wireless.

servicePlan?string

The code for a different service plan, if you want to change the service plan while changing the device identifier. Set this parameter to one of the Code values returned by GET /plans.

zipCode?string

The ZIP code from which the MDN and MSISDN will be derived when assignNonGeoMDN is true. Specify the zip code of the location where the line of service will primarily be used.

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

Response Body

application/json

application/json

curl -X PUT "https://example.com/m2m/v1/devices/string/actions/deviceId" \  -H "Content-Type: application/json" \  -d '{    "deviceIds": [      {        "id": "42590078891480000008",        "kind": "iccid"      }    ],    "deviceIdsTo": [      {        "id": "89148000000842590078",        "kind": "iccid"      }    ],    "change4gOption": "ChangeICCID",    "zipCode": "98802",    "servicePlan": "4G 2GB"  }'
{  "requestId": "a28892ea-6503-4aa7-bfa2-4cd45d42f61b"}