Favicon

You are here: Home > API Reference > Windows > Windows Devices

Windows Devices

API endpoints for Windows Devices. Browse all available operations, parameters, and response schemas.

GET List enrolled Windows devices with filtering options.
/organizations/:organizationId/mdm/windows/enterprise/devices/

**Required Permission:** `mdm.windows.device.list` Retrieves a comprehensive list of enrolled Windows devices including status, configuration, and assignments with specific options for filtering and pagination.

GET Retrieve detailed Windows device configuration and status.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId

**Required Permission:** `mdm.windows.device.get` Retrieves comprehensive details for a specific Windows device including operating system information, enrollment status, applied policies, and compliance state metrics.

PUT Update Windows device configuration and assignments.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId

**Required Permission:** `mdm.windows.device.update` Modifies the device properties including display names, tags, and policy assignments to maintain accurate inventory and apply security configurations consistently.

DELETE Remove Windows device from MDM system.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId

**Required Permission:** `mdm.windows.device.remove` Marks the device as deleted in the system, revoking access and preventing future management or communication with platform servers completely.

POST Execute remote application management actions.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/action

**Required Permission:** `mdm.windows.device.action` Sends a remote command to the device to install or uninstall specific applications from the organization's software catalog, inventory list.

GET Retrieve MDM agent configuration settings.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/agent-config

**Required Permission:** `mdm.windows.device.get` Fetches current configuration settings for the device agent including server endpoints, polling intervals, and operational parameters for effective management, purposes.

GET Retrieve agent configuration assets and certificates.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/agent-config-assets

**Required Permission:** `mdm.windows.device.get` Provides access to necessary configuration files and certificates required by the agent to establish secure communication with platform servers successfully.

GET Retrieve device agent authentication tokens.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/agent-tokens

**Required Permission:** `mdm.windows.device.get` Fetches current authentication credentials and tokens used by the device agent to maintain secure connectivity with management services communication endpoints.

GET List installed applications on a Windows device.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/applications

**Required Permission:** `mdm.windows.device.get` Retrieves a complete inventory of applications installed on the device, including version details and installation dates for compliance analysis, purposes.

POST Clear device cache and force refresh.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/clean-cache

**Required Permission:** `mdm.windows.device.cleanCache` Triggers a process to clear server-side cache and requests a full update of device details from the agent immediately afterwards.

POST Request selective device information refresh.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/info

**Required Permission:** `mdm.windows.device.info` Commands the device to update specific data categories such as hardware or applications without performing a full synchronization cycle, execution.

PUT Move winDevice to segment
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/move

**Required Permission:** `mdm.windows.device.move` Move winDevice to segment

GET List scheduled automation scripts for device.
/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/scheduler-scripts

**Required Permission:** `mdm.windows.device.get` Retrieves details of scripts configured to run periodically on the device, including execution schedules and parameter configuration settings definitions list.