Execute remote application management actions.

POST

/v1/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.

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

winDeviceId string

required

Windows device identifier used for targeting operations, supporting MongoDB ObjectId, IMEI, or serial number formats for flexible device lookup.

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

Body Params application/json

action string required

Remote management action to execute on the device specifying operation type.

install uninstall

entity string required

Target entity type for the action such as application, policy, or configuration.

application

id string required

Identifier of the specific entity to perform the action on within the Windows management system.

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

{
    "action": "install",
    "entity": "application",
    "id": "507f1f77bcf86cd799439088"
}

200 Response application/json

status boolean optional

data object optional

status string optional

Action execution result status indicating whether the command was successfully queued or failed.

≤ 256 characters

{
    "status": true,
    "data": {
        "status": "queued"
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

5025

message string optional

Not supported

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