Skip to main content

Queued Run

Get or cancel a single queued flow run.

Queued Run

GET /api/runs/queue/{queueId}?filter[organizationId]=org_123
DELETE /api/runs/queue/{queueId}?filter[organizationId]=org_123

Fetch queue item details or cancel a waiting run (releases any credit hold).

Try it

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

get/api/runs/queue/{queueId}

Get queued run

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/{queueId}' \
  -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.

Path Parameters

ParameterTypeRequiredDescription
queueIdstringYesQueue item ID returned from a 202 trigger response

Query Parameters

ParameterTypeRequiredDescription
filter[organizationId]stringYesOrganization that owns the queue item

Cancel

DELETE cancels a waiting item, marks linked run history cancelled when applicable, and releases reserved credits. Missing or cross-tenant IDs return 404 (non-enumeration).

On this page