Skip to main content

List Queued Runs

List flow runs waiting in the organization queue when concurrency limits are reached.

List Queued Runs

GET /api/runs/queue?filter[organizationId]=org_123

Returns waiting/dispatching queue items for the authorized organization.

Try it

Live requests run from your browser. Open the API Explorer to try every operation from one screen.

get/api/runs/queue

List queued runs

Requests go to the live API from your browser. The docs server never sees this key.

curl -X GET 'https://api.actionflows.ai/api/runs/queue' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'

Response

Send a request to see the response.

Authentication

Required. See API Reference for authentication details.

Query Parameters

ParameterTypeRequiredDescription
filter[organizationId]stringYesOrganization that owns the queue

Response

{
  "success": true,
  "data": [
    {
      "id": "queue_123",
      "status": "waiting",
      "actionFlowId": "flow_123",
      "runHistoryId": "runhist_123",
      "createdAt": "2024-01-01T00:00:00.000Z"
    }
  ]
}

When POST /api/runs returns 202, poll this list or GET queue item until the run is dispatched.

On this page