Contents

Assign a Profile

Assign a profile to a list of devices.

URL

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

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
AssignProfileResponse

400Bad Request

  • DEVICE_ID_REQUIRED: The request did not contain any device IDs.

  • PROFILE_UUID_REQUIRED: The request did not contain a profile ID.

  • USER_AGENT_INVALID: The User-Agent header is invalid.

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

404Not Found

The profile with the specified UUID could not be found.

Mentioned in

Discussion

To avoid performance issues, limit requests to 1000 devices at a time.

Throttling

With X-Server-Protocol-Version 9 and later, the server may throttle profile assignment on a per-device basis. When the server throttles a device, its value in the devices dictionary is THROTTLED instead of SUCCESS.

With X-Server-Protocol-Version 10 and later, the response also includes retry_after_seconds when at least one device is throttled. Clients should wait for at least the indicated number of seconds before retrying assignment for the throttled devices.

HTTP Body

The request for assigning a profile to a set of devices.

Topics

Request and Response

See Also

Profile management