Validate policy composition

POST

/v1/organizations/:organizationId/mdm/apple/enterprise/policies/composition

Validate policy composition

Required Permission: mdm.apple.policy.composition

Validates policy configuration structure and checks for conflicts or incompatible settings.

Request

Add parameter in header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

Body Params application/json

admPolicyAssignments array [object] optional

Ordered list of Apple device policy assignments applied to target with priority-based configuration inheritance and composition.

admPolicyId string optional

Match pattern: ^[a-fA-F0-9]{24}$

priority integer required

≥ 0 · ≤ 10000

targetId string optional

Target entity identifier for policy composition validation representing device or device user receiving policy assignments.

Match pattern: ^[a-fA-F0-9]{24}$

targetType string optional

Policy application scope defining whether configurations apply to entire device or device user context only.

device deviceUser

{
    "admPolicyAssignments": [
        {
            "admPolicyId": "698f42e5457fafa13d088794",
            "priority": 1
        }
    ],
    "targetId": "698f42e5457fafa13d088794",
    "targetType": "device"
}

Responses

200 Response application/json

status boolean optional

data object optional

composedPolicy object optional

Merged policy configuration resulting from priority-based composition of multiple assigned policies with conflict resolution.

summary object optional

Policy composition summary providing overview of merged settings conflicts resolved and effective configuration applied to target.

{
    "status": true,
    "data": {
        "composedPolicy": {},
        "summary": {}
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4004

message string optional

Invalid Token

{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}

404 Response application/json

status boolean optional

false

error object optional

code number optional

3001

message string optional

Entity not found

{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}