GET /runners
Lists all runner sets for the authenticated organization. Runner sets define the configuration templates for runner instances that will be provisioned when CI/CD jobs request matching labels. You can filter the results by image, provider, VCS integration, and other criteria using query parameters.
In: header
Query Parameters
Image
list of runner set id's
provider kind id
Deprecated: ignored — runner sets are organization-global
active
labels
Response Body
application/json
application/json
curl -X GET "https://example.com/runners"[ { "active": true, "configuration": { "byoc_sku": { "arch": "x64", "imdsv2_required": true, "instance_types": [ "m5.xlarge", "m5.2xlarge" ], "is_public": false, "network_tier": "STANDARD", "role_arn": "arn:aws:iam::123456789012:role/WarpBuildRole" }, "capacity_type": "ondemand", "image": "ubuntu-2404", "sku": "warp-ubuntu-2404-x64-4x", "storage": { "disk_type": "pd-balanced", "iops": 0, "performance_tier": "P15", "size": 0, "throughput": 0, "tier": "low" } }, "created_at": "string", "id": "runner_abc123", "labels": [ "warp-ubuntu-2404-x64-4x" ], "meta": {}, "name": "my-ubuntu-runner", "organization_id": "org_abc123", "provider_id": "cloud_xyz789", "stock_runner_id": "stock_xyz", "updated_at": "string", "vcs_integration_id": "vcs_abc123" }]GET /runner_pool
Lists all runner pools for the authenticated organization. Runner pools allow you to configure warm pools of pre-provisioned runner instances for faster job startup times. A pool maintains a specified number of idle runner instances ready to be allocated immediately when a job is queued.
PATCH /runners/default-group
Sets or updates the default runner group for a specific VCS integration. The default runner is used when CI/CD workflows don't specify explicit runner labels.