Check policy assignment status

GET

/v1/organizations/:organizationId/mdm/windows/enterprise/policies/:winPolicyId/assignations

Check policy assignment status

Required Permission: mdm.windows.policy.get

Check if Windows policy is currently assigned to any devices or groups providing deployment status for deletion validation.

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,}))$

winPolicyId string

required

Windows policy identifier used for retrieving, updating, or deleting specific policy configurations within the management system.

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

Responses

200 Response application/json

status boolean optional

data object optional

assigned boolean optional

Assignment status indicating whether policy is currently deployed to any devices or groups in the organization.

items object optional

Assignment details object containing information about devices, groups, or users where policy is deployed.

{
    "status": true,
    "data": {
        "assigned": true,
        "items": {
            "deviceCount": 15,
            "groupCount": 2
        }
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4001

message string optional

Unauthorized

{
    "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"
    }
}