GET /held
The runs held because the Mac could not do them yet (locked, an app missing…), and the ones that finished recently.
Details #
Returns a list, oldest first: id, macro, macroName, inputs, firedBy, reason (what it waits on now), firstReason, createdAt, expires, status (held, released, dropped or expired), endedAt and runId. A blocker is {"kind": "locked"}, or {"kind": "appNotRunning", "which": "com.apple.Safari"}. Without a query only held runs are listed; ?all=1 adds the ones that finished in the last 7 days.
curl -s -H "Authorization: Bearer $TOKEN" "http://127.0.0.1:48080/held"
Parameters #
curl --unix-socket "$SWITCHBOARD_HOME/engine.sock" -X GET http://localhost/held
The runs held because the Mac could not do them yet, and the ones that finished recently. The Unix socket needs no token; loopback 127.0.0.1:48080 needs Authorization: Bearer <api-token>.