The operation POST /environments/{{envID}}/users/{{userID}}/devices with required header Content-type: application/vnd.pingidentity.devices.reorder+json explicitly orders a user’s active devices according to the request body. The device listed first becomes the default device.

After you set the device order, subsequently activated devices are appended to the end of the order list. You can reorder devices with this operation as many times as needed.

For more information, see Setting device order.

Prerequisites

Property Type Required?
order.id String Required
block.status String Optional
block.blockedAt Date Optional
lock.status String Optional
lock.expiresAt Date Optional
policy.id String Optional
policy.type String Optional
nickname String Optional

See the Device properties data model for full property descriptions.