CoderHelm Docs
APIRuns

List runs

GET
/api/runs

Lists the team's runs, newest first, one page at a time. Search with q and filter by status, source and repo. Each page reads at most a few hundred runs, so a page can come back short, or empty, with next set: keep reading until next is null.

Authorization

api_key view
headerAuthorizationBearer <token>

A team API key, made by an admin under Settings, API keys. Send it as Authorization: Bearer chk_....

Scope: view

Query Parameters

source?string

Only runs from this source, such as github, jira or alert.

limit?integer

Runs per page, 1 to 100. Default 50.

Formatint32
Range1 <= value <= 100
cursor?string

next from the previous page (the last run id it covered).

q?string

Search words: ticket key or number, title, repo, PR number, status.

status?string

Comma-separated exact statuses, e.g. failed,cancelled.

repo?string

One repo, owner/name (exact, case-insensitive).

Response Body

A page of runs.

application/json
  1. response

A page of runs.

next?|

Pass as cursor to read on; null when there are no older runs.

Example"01JB8W2Q7N4D6R8S0T2V4X6Z8A"
runs*array<>

Runs that match, newest first. Can be short, or empty, while next is set: older runs are still unread.

scanned*integer

How many runs were read to fill this page (searches and filters skip some).

Range0 <= value
Example50
curl -X GET 'https://api.coderhelm.com/api/runs?source=jira&limit=20&q=WEB-42&status=failed%2Ccancelled&repo=acme%2Fweb' \  -H "Authorization: Bearer $CODERHELM_API_KEY"
{  "next": "01JB8W2Q7N4D6R8S0T2V4X6Z8A",  "runs": [    {      "cost_usd": 1.42,      "created_at": "2026-10-22T14:03:11Z",      "current_pass": "pr",      "duration_s": 734,      "pr_number": 318,      "pr_url": "https://github.com/acme/web/pull/318",      "repo": "acme/web",      "run_id": "01JB8X6F4M2C9QZ3T7V5W1K0HA",      "status": "completed",      "ticket_id": "WEB-42",      "ticket_source": "jira",      "title": "Add rate limiting to the login form",      "tokens_in": 182340,      "tokens_out": 20511    }  ],  "scanned": 50}
Edit on GitHub

List reviews GET

Lists the reviewer's pull request reviews, newest first, one page at a time, for the whole team or one repository. Bodies are cut to about 4,000 characters and findings are left out; get a review by its `sk` for both.

Get a run GET

Returns one run in full: its status and current step, the pull requests and branches it opened, the files it changed, token use and cost, and the notes it wrote while working. Poll it to follow a run; a few seconds apart is plenty.