WarpBuild LogoWarpBuild Docs
Runners

GET /runners/usage

Retrieves usage statistics for runners within a specified date range. Returns aggregated data about runner execution times, job counts, and resource consumption for billing and monitoring purposes.

GET
/runners/usage

Authorization

Authorization<token>

In: header

Query Parameters

start_date*string

Date range start

end_date*string

Date range end

capacity_types?array<>

Capacity types

archs?array<>

Architectures

images?array<>

Images

cores?array<>

Cores

runner_types?array<>

Runner types

search_term?string

Search term

stack_ids?array<string>

Stack ids

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/runners/usage?start_date=string&end_date=string"
{  "daywise": [    {      "date": "string",      "runtime_seconds": 0    }  ],  "runnerwise": [    {      "runner_id": "string",      "runtime_seconds": 0    }  ],  "total_job_count": 0,  "total_runtime_seconds": 0}

GET /runners/default-group

Retrieves the default runner group configuration for a specific VCS integration. The default group determines which runner is used when a workflow does not specify explicit runner labels.

GET /runner_instance

Lists all runner instances for the authenticated organization with optional filtering and pagination. You can filter by labels, status, creation date, job ID, and search across multiple fields.