List warm runs

Returns on-demand warm run history for a site, newest first.

GET /v1/sites/{id}/warm-runs

Requires scope: boosts:read

Path parameters

Parameter	Type	Required	Description
`id`	integer	Required	Site ID.

Query parameters

Parameter	Type	Description
`limit`	integer	Number of results to return. Default: 20, max: 100.
`offset`	integer	Pagination offset. Default: 0.

Example request

curl https://api.cache-boost.com/v1/sites/42/warm-runs \
  -H "Authorization: Bearer cb_live_YOUR_KEY"

Response

Returns 200 OK.

{
  "data": [
    {
      "id": 91,
      "status": "done",
      "status_message": null,
      "source_urls": ["https://www.example.com/", "https://www.example.com/about"],
      "run_region": ["fr", "us"],
      "started_at": "2025-01-15T10:31:00Z",
      "finished_at": "2025-01-15T10:31:45Z",
      "summary": {
        "total_calls": 4,
        "successful_calls": 4,
        "failed_calls": 0,
        "cache_hits": 3,
        "average_response_time_ms": 98.2,
        "pops": { "CDG": 2, "IAD": 2 }
      },
      "created_at": "2025-01-15T10:30:58Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

Errors

Code	Description
`401`	Missing or invalid API key.
`403`	Insufficient scope or access denied.
`404`	Site not found.