GoRunner docs
Search or askSearch⌘K

List waiting runs

Since v2026.10.6

GET/api/runs/waiting

Lists the workflows that have runs waiting in line, most first, with the total.

Needs an API token with the Read permission for runs (run:read).

Request

It takes no parameters.

Cancel them

Each count is exactly what Cancel waiting runs would cancel for that workflow now. The Runs page asks this before its Cancel N queued… key.

Responses

  • 200OK

    The workflows with runs in line. Test runs count too.

  • The token lacks the Read permission for runs.

  • The count failed. Try again.

Any call can also answer: 401 UNAUTHORIZED · 401 TOKEN_ENDED · 403 TOKEN_SURFACE_OFF · 403 FEATURE_OFF · 403 EMBED_NOT_ALLOWED · 403 EMBED_NOT_AVAILABLE · 403 ACCOUNT_SUSPENDED · 429 RATE_LIMITED · 503 BUSY · 503 PAUSED · 503 SERVICE_UNAVAILABLE. See Errors.

Request

GORUNNER="https://api.gorunner.io"
GORUNNER_TOKEN="grt_…"  # needs Read for runs

curl "$GORUNNER/api/runs/waiting" \
  -H "Authorization: Bearer $GORUNNER_TOKEN"

Response · 200 OK

json
{
  "data": {
    "waiting": 7,
    "workflows": [
      {
        "id": "3b1e5c2a-7d4f-4e8b-a1c6-5f2d9b0e7a31",
        "name": "Order intake",
        "waiting": 5
      },
      {
        "id": "6e9a1c3f-8b2d-4a57-9e0c-3f7b5d1a8c42",
        "name": "Follow up with new sign-ups",
        "waiting": 2
      }
    ]
  }
}
Every field

It takes no body.

Response · 200 OK

dataobject
waitinginteger

Runs waiting in the line that have not started, every workflow together.

workflowsarray of objects

Each workflow with runs in line, most first.

idUUID
namestring
waitinginteger