Request selective device information refresh.

POST

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

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

info array [string] required

Array of information categories to refresh from the device agent without performing full synchronization.

{
    "info": [
        "hardware",
        "applications",
        "certificates"
    ]
}

200 Response application/json

status boolean optional

data object optional

status boolean optional

Refresh operation status indicating whether the device info request was successfully sent.

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

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