Declarative Management
Sends declarative management requests to the server.
URL
PUT https://yourmdmhost.example.com/checkin#DeclarativeManagementRequestResponse Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK |
Mentioned in
Discussion
The Data field is optional, depending on the Endpoint value, as described below:
tokensThe client uses the
tokensendpoint to request the current synchronization tokens from the server. It doesn’t use theDatafield. A successful response to this request is a200 OKHTTP status, with a response body that’s a JSON object conforming to the TokensResponse schema.declaration-itemsThe client uses the
declaration-itemsendpoint to request the current declaration manifest from the server. It doesn’t use theDatafield. A successful response to this request is a200 OKHTTP status, with a response body that’s a JSON object conforming to the DeclarationItemsResponse schema.declaration/…/…The client uses the
declaration/…/…endpoint to request a specific declaration from the server. It doesn’t use theDatafield.
The endpoint value is a path with three segments separated by a slash character (/). The first segment is always declaration. The second segment indicates the declaration type and is one of activation, asset, configuration, or management. The third segment is the Identifier of the declaration to fetch.
A successful response to this request is a 200 OK HTTP status, with a response body that’s a JSON object representing the requested declaration. If the declaration isn’t present on the server, it needs to return a 404 Not Found HTTP status response to the device. That causes the device to remove any corresponding declaration that is present on it.
statusThe client uses the
statusendpoint to send a status report to the server. TheDatafield needs to be present and set to a Base64-encoded JSON object conforming to the StatusReport schema. A successful response to this request is a200 OKHTTP status, with an empty response body.
Check-in availability
Device channel | iOS, macOS, Shared iPad, tvOS, visionOS, watchOS |
User channel | macOS, Shared iPad |
Requires supervision | NA |
Allowed in user enrollment | iOS, macOS, visionOS |
HTTP Body
The request object the system sends for the DeclarativeManagement request.