Request
To add devices to and/or remove devices from the account's approved devices list, send a POST request to:
https://<host>:<port>/adm/v1/user/devices/amendapprovals
Headers
-
x-correlation-id– identifier for logging, to correlate messages across a call flow -
nv-tenant-id– the tenant ID -
token– request authentication token
Mandatory arguments
One or both of the following:
-
deviceToApprove– the ID of the device to be added to the approved devices list (in body) -
deviceToUnapprove– the ID of the device to be removed from the approved devices list (in body)
Other arguments
None
Example
A POST request with this payload will add the device with the ID 123 to the approved devices list and remove the device with ID 456:
{
"deviceToApprove": "123",
"deviceToUnapprove "456"
}
Response
A successful request returns an HTTP 201 status.
A bad request returns an HTTP 400 status.
An unauthorised request returns an HTTP 401 status.
A forbidden request returns an HTTP 403 status.
If the specified device does not exist, the request returns an HTTP 404 status.
See also
For full details of this API, see the Account and Device Manager (ADM) API documentation.