Retry a run
Starts the run's ticket again as a new run. Only a run that is failed, needs_input, needs_outside_change, cancelled or closed can be retried; the old run becomes retried, so retrying it twice is refused with 400. Find the new run with GET /api/runs?q=<ticket id>.
api_key runsAuthorizationBearer <token>A team API key, made by an admin under Settings, API keys. Send it as Authorization: Bearer chk_....
Scope: runs
run_id*stringThe run's id.
The ticket is queued again.
application/json- response
What a run action did.
status*stringretrying after a retry, cancelled after a cancel.
"retrying"curl -X POST 'https://api.coderhelm.com/api/runs/01JB8X6F4M2C9QZ3T7V5W1K0HA/retry' \ -H "Authorization: Bearer $CODERHELM_API_KEY"{ "status": "retrying"}Cancel a run POST
Stops a run that is `running`. The run becomes `cancelled`, and the work it has not done yet is dropped; a pull request it already opened stays open. A run in any other state answers `400`, so cancelling twice is harmless.
Get this month's usage GET
Returns the tokens the team used this calendar month (UTC), split into new input, output, cache reads and cache writes, per feature, and against each limit the team set. When a limit is reached, endpoints that start work answer `429` with `token_limit_reached` until the month turns or an admin raises it.