List Runners

List available runners for the organization. Fetches health data for each runner and optionally filters by component health.

Query Parameters:

• component: Optional component name to filter by (workflow_engine, tool-manager, etc.)

Returns only runners with the specified healthy component, or all runners if no filter specified.

GET /api/v1/runners

List Runners

cURL

curl --request GET \
  --url https://control-plane.kubiya.ai/api/v1/runners \
  --header 'Authorization: Bearer <token>'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Query Parameters

component · string | null

Filter runners by healthy component (e.g., 'workflow_engine', 'tool-manager'). If not specified, returns all runners with health data.

Response

200

application/json

Successful Response