v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB
Endpoints

List device mapping

Returns a list of user-to-device mapping created to perform a mass deployment in a non-AD/LDAP environment or perform bulk replace of devices.

get/endpoints/v1/devicemappings

Query parameters

emailIDstring

Filter to list device mappings using the email address of a user.

deviceIdentifierType'serial-number' | 'uuid' | 'hostname'

Filter to list device mappings using the unique device identifier type of the device.(serial-number, uuid, or hostname).

deviceIdentifierstring

Specify the unique id of the device for the selected deviceIdentifierType in inSync.

restoreData'All' | 'Data' | 'System'

Filter to list device mappings using the type of data restore performed

Response

OK

totalSizeinteger

The total number of device mappings listed on the result page. Example - 3

nextPageTokenstring

The token to access next page of results. This parameter will be empty for the last page of results.

Example response

{
  "totalSize": 1,
  "nextPageToken": "MTExMQ==",
  "imdMappings": [
    {
      "mappingID": "3452rw6",
      "emailID": "ernie.carter@druva.com",
      "userName": "Ernie Carter",
      "deviceName": "Ernie Carter's Macbook",
      "deviceIdentifierType": "Serial Number",
      "deviceIdentifier": "Po3XF",
      "oldDeviceName": "Ernie Carter's Old Macbook",
      "restoreData": "SYSTEM"
    }
  ]
}