Favicon

You are here: Home > API Reference > Windows > Windows Devices > List scheduled automation scripts for device.

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

GET
https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices/{winDeviceId}/scheduler-scripts
curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices/{winDeviceId}/scheduler-scripts" \
  -H "Authorization: Bearer <YOUR_API_KEY>"
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices/{winDeviceId}/scheduler-scripts", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();
import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices/{winDeviceId}/scheduler-scripts",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request 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.
scope string optional
Execution context for the script, defining whether it runs at the system level (machine) with administrative privileges or within the specific session and permissions of the currently logged-in user.
user machine
{
    "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",
            "scope": "machine"
        }
    ]
}
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"
    }
}