List scheduled automation scripts for device.

GET

/v1/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/scheduler-scripts

List scheduled automation scripts for device.

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.

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

Responses

200 Response application/json

status boolean optional

data array [object] optional

id string optional

Unique identifier for this scheduled script configuration enabling targeted management operations.

≤ 128 characters

type string optional

Script execution type classification such as recurring, one-time, or event-triggered determining scheduling behavior.

once loop onDemand

loopTime integer optional

Execution interval in minutes for recurring scripts controlling how frequently the script runs on the device.

≥ 0

resetDate string optional

Timestamp when the script execution schedule resets or when next execution cycle begins.

Format: date-time

name string optional

Descriptive name for this scheduled script displayed in management interfaces for identification.

≤ 256 characters

description string optional

Detailed explanation of script purpose, functionality, and expected outcomes for administrative reference.

≤ 500 characters

runner string optional

Script execution environment or interpreter such as PowerShell, cmd, or Python determining how script executes.

≤ 256 characters

arguments string optional

Command-line arguments and parameters passed to the script during each scheduled execution.

{
    "status": true,
    "data": [
        {
            "id": "scheduler-script-550e8400",
            "type": "onDemand",
            "loopTime": 120,
            "resetDate": "2026-02-11T00: 00: 00.000Z",
            "name": "Daily Security Audit",
            "description": "Performs daily security compliance checks and generates audit reports",
            "runner": "powershell.exe -ExecutionPolicy Bypass",
            "arguments": "-AuditLevel Full -OutputPath C:\\Logs\\audit.log"
        }
    ]
}

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