Skip to content

Devices and agent

Enrolled devices, device groups, enrollment tokens, assignments, install issues and Intune onboarding.

The permission column lists what the route checks. An API token needs one of them as a scope. Where a route lists several, the route checks them for different parts of the request.

Method Path Permission
GET /api/assignments devices:read
GET /api/assignments/:id devices:read
POST /api/assignments/:id/approve devices:assign
POST /api/assignments/:id/cancel devices:assign, devices:write
POST /api/assignments/:id/membership devices:assign, devices:write
POST /api/assignments/:id/pause devices:kill, devices:assign, devices:write
POST /api/assignments/:id/promote devices:assign
POST /api/assignments/:id/reject devices:assign
GET /api/assignments/:id/results devices:read
POST /api/assignments/:id/resume devices:kill, devices:assign, devices:write
POST /api/assignments/:id/versions/:versionId/approve devices:assign
GET /api/device-correlation-overrides devices:read
POST /api/device-correlation-overrides devices:write
DELETE /api/device-correlation-overrides/:id devices:write
GET /api/device-groups devices:read
POST /api/device-groups devices:write
PATCH /api/device-groups/:id devices:write
DELETE /api/device-groups/:id devices:write
POST /api/device-groups/:id/managed devices:assign, devices:write
POST /api/device-groups/:id/managed/approve devices:assign
GET /api/device-groups/:id/members devices:read
POST /api/device-groups/:id/members devices:write
DELETE /api/device-groups/:id/members/:deviceId devices:write
GET /api/device-settings devices:read, devices:write
PATCH /api/device-settings devices:write
POST /api/device-settings/pause-actions devices:kill
POST /api/device-settings/rotate-inventory-secret devices:write
GET /api/device-tokens devices:read
POST /api/device-tokens devices:write
POST /api/device-tokens/:id/revoke devices:write
POST /api/device-tokens/:id/rotate devices:write
GET /api/devices devices:read
GET /api/devices/:id devices:read
GET /api/devices/:id/actions devices:read
POST /api/devices/:id/approve devices:write
POST /api/devices/:id/contests/:packageId/clear devices:assign
GET /api/devices/:id/export devices:read
GET /api/devices/:id/history devices:read
POST /api/devices/:id/reactivate devices:write
POST /api/devices/:id/refresh-inventory devices:write
POST /api/devices/:id/resolve-conflict devices:write
POST /api/devices/:id/retire devices:write
POST /api/devices/:id/revoke devices:write
GET /api/devices/:id/software devices:read
POST /api/devices/:id/suspend devices:write
GET /api/devices/agent-versions devices:read
GET /api/devices/not-in-catalog devices:read
GET /api/devices/summary devices:read
GET /api/install-issues issues:read
GET /api/install-issues/:id issues:read
PATCH /api/install-issues/:id issues:write
POST /api/install-issues/:id/comments issues:write
GET /api/install-issues/:id/history issues:read
GET /api/install-issues/settings issues:read, settings:write
PATCH /api/install-issues/settings settings:write
GET /api/intune-kit packages:read, devices:read
GET /api/intune-kit/download packages:read, devices:read
GET /api/intune-kit/onboarding packages:read, devices:read

This page is generated from the API route inventory. 58 endpoints.