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.

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.