Trigger a run
Manually trigger a boost run immediately. The response is 202 Accepted — the run is queued and processed asynchronously. Poll GET /v1/runs/{run_id} to track progress.
POST
/v1/boosts/{id}/run
Requires scope: boosts:write
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
integer | Required | Boost ID. |
Body parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
validation_ratio |
integer | Optional | Percentage of calls re-checked for this run only: 0, 1, 10, 50 or 100. Default: the boost's validation_ratio. |
Example request
curl -X POST https://api.cache-boost.com/v1/boosts/15/run \
-H "Authorization: Bearer cb_live_YOUR_KEY"Response
Returns 202 Accepted.
{
"run_id": 88,
"status": "pending"
}The run is asynchronous. Use the returned run_id to poll GET /v1/runs/{id} for progress.
Errors
| Code | Description |
|---|---|
401 | Missing or invalid API key. |
403 | Insufficient scope or access denied. |
404 | Boost not found. |
409 | A run is already in progress for this boost, or the boost is paused (resume it first). |