List Queue Workflows

List workflows/tasks for a worker queue.

Returns list of workflows with status counts and filtering options.

GET /api/v1/worker-queues/{queue_id}/workflows

List Queue Workflows

cURL

curl --request GET \
  --url https://control-plane.kubiya.ai/api/v1/worker-queues/{queue_id}/workflows \
  --header 'Authorization: Bearer <token>'

200

{
  "workflows": [
    {
      "workflow_id": "<string>",
      "run_id": "<string>",
      "task_queue": "<string>",
      "status": "<string>",
      "execution_id": "<string>",
      "workflow_type": "<string>",
      "worker_id": "<string>",
      "started_at": "2023-11-07T05:31:56Z",
      "close_time": "2023-11-07T05:31:56Z",
      "attempt": 1,
      "history_length": 0
    }
  ],
  "total": 123,
  "pending_count": 0,
  "running_count": 0,
  "completed_count": 0,
  "failed_count": 0
}

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Path Parameters

queue_id · string · required

Query Parameters

status_filter · string | null

limit · integer · default: 100

Response

200

application/json

Successful Response

Response for list queue workflows

workflows · WorkflowListItem · object[] · required

List of workflows

Show child attributes

total · integer · required

Total number of workflows

pending_count · integer · default: 0

Number of pending workflows

running_count · integer · default: 0

Number of running workflows

completed_count · integer · default: 0

Number of completed workflows

failed_count · integer · default: 0

Number of failed workflows