REST API

# ServerEngine v5 - jobs run through the ServerEngine service.
# Copy the API token from the app's API tab (Copy button). The control
# API serves HTTPS on 127.0.0.1:5001 by default (local only - use a
# reverse proxy of your choice for remote access). The certificate is
# self-signed: import the ServerEngine-CA to trust it, or on
# PowerShell 7+ add -SkipCertificateCheck to each call.
$token = "se_paste-your-token-here"
$base  = "https://127.0.0.1:5001/api/v1"

$headers = @{
    "Content-Type"  = "application/json"
    "Authorization" = "Bearer $token"
}

# --- Run a script, runbook or installer right now ---
$body = @{
    target     = "(This Computer)"   # host FQDN or group name
    run        = "myscript.ps1"      # script, .runbook or installer

    # dynamic parameters: every xTest1 in your script is
    # replaced with someText before it runs
    parameters = "[VAR:xTest1,VAL:someText][VAR:xTest2,VAL:more]"
} | ConvertTo-Json

$job = Invoke-RestMethod -Uri "$base/jobs" -Method POST -Headers $headers -Body $body
$id  = $job.jobIds[0]

# --- Wait for the job to finish, then print its console output ---
do {
    Start-Sleep -Seconds 2
    $state = (Invoke-RestMethod -Uri "$base/jobs" -Headers $headers) |
             Where-Object id -eq $id
} while ($state -and $state.status -notmatch "Completed|Failed")

(Invoke-RestMethod -Uri "$base/jobs/$id/output" -Headers $headers).output

# --- Or schedule it instead (creates a Windows Scheduled Task) ---
$sid  = [guid]::NewGuid().ToString("N")
$body = @{
    time    = (Get-Date).AddMinutes(5).ToString("HH:mm")
    date    = (Get-Date).ToString("yyyy.MM.dd, dddd",
              [Globalization.CultureInfo]::InvariantCulture)
    interval = "One time"  # or: Every (5m/15m/30m/1h/2h/3h/6h/12h),
                           # Daily (24h), Weekly (7 days), Monthly (28 days)
    target   = "(This Computer)"
    run      = "myscript.ps1"
    state    = "Enabled"
} | ConvertTo-Json
Invoke-RestMethod -Uri "$base/schedules/$sid" -Method PUT -Headers $headers -Body $body