Contents

Sync the List of Devices

Get updates about the list of devices the server manages.

URL

POST https://mdmenrollment.apple.com/devices/sync

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
FetchDeviceResponse

400Bad Request

  • CURSOR_REQUIRED: The cursor value was not provided in the request body.

  • INVALID_CURSOR: An invalid cursor value was provided.

  • EXHAUSTED_CURSOR: The cursor had returned all devices in previous calls.

  • EXPIRED_CURSOR: The provided cursor is older than 7 days.

  • USER_AGENT_INVALID: The User-Agent header is invalid.

  • USER_AGENT_MISSING: The User-Agent header is missing or has no assigned value.

Discussion

The sync service depends on a cursor returned by the fetch device service. It returns a list of all modifications (additions or deletions) since the specified cursor. The cursor passed to this endpoint should not be older than 7 days.

This service may return the same device more than once. You must resolve duplicates by matching on the device serial number and the op_type and op_date fields. The record with the latest op_date indicates the last known state of the device in DEP.

HTTP Body

The request to sync the list of devices.

Topics

Request

See Also

Device Management