Search the docs

Search guides, API endpoints and MCP tools.

Test runs

list_test_runs

Read grantRead-onlyIdempotent

List published test runs, newest first, 50 at a time: each run's number, product, environment, commit, branch, result and counts. Filter to find the run for a change, then read it with get_test_run. Send nextCursor as cursor for the next page. Needs read access.

Inputs

productstring

Only this product's runs, by slug, such as storefront.

environmentstring

Only runs against this environment, by slug, such as staging.

resultstring

Only runs with this result; flaky runs passed after retries.

One ofpassedfailedflaky
querystring

Words in the branch or commit subject, or the start of a commit SHA.

commitstring

Only runs of this exact commit SHA.

mineboolean

Only runs your person published.

cursorinteger

The previous page's nextCursor: runs numbered below it.

From -9,007,199,254,740,991 to 9,007,199,254,740,991
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "list_test_runs",    "arguments": {      "product": "storefront",      "result": "failed"    }  }}
POST/clanker/v1/test-runs:list
curl -X POST https://api.clankership.com/clanker/v1/test-runs:list \  -H "Authorization: Bearer $CLANKER_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "product": "storefront",    "result": "failed"  }'
The same call over the clanker HTTP API. Set CLANKER_TOKEN to a clanker OAuth access token.