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<string>

Capacity types

archs?array<string>

Architectures

images?array<string>

Images

cores?array<integer>

Cores

runner_types?array<string>

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://api.warpbuild.com/api/v1/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
}
{
  "code": "string",
  "description": "string",
  "message": "string",
  "sub_code": "string",
  "sub_message": "string"
}
{
  "code": "string",
  "description": "string",
  "message": "string",
  "sub_code": "string",
  "sub_message": "string"
}

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.