trickroom / Docs
Sign in
API reference/observability

List recent evaluation runs with pass rate, efficiency and cost

The 20 newest evaluation runs across the workspace (or the application), including scheduled canaries, with each version's summary and billed cost but not their samples.

GET/v1/evaluations

Authorization

Authorizationstringrequired

Bearer tak_… — an application API key. Keep it on your backend; all resources are scoped to that application.

Create an application key →

Query parameters

application_idstring

Optional with an application key, which always pins the scope. A different application returns 403.

Min length: 1

Response

200List recent evaluation runs with pass rate, efficiency and cost
X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

dataarray<object>required
Item fields
idstringrequired
application_idstringrequired
application_namestringrequired
created_atstringrequired
suite_namestring | nullrequired
labelstring | nullrequired
max_cost_usdnumber | nullrequired
result_jsonobjectrequired

Additional keys: any

billed_nanoobjectrequired

Additional keys: any

Additional keys: any

4XX400 invalid input; 401 missing/revoked credentials; 403 disallowed operation/application; 404 missing or inaccessible resource; 409 conflicting submission/version/state; 413 body too large; 415 unsupported content type. Inspect error.code, not message text.
X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

errorobjectrequired
Object fields
codestringrequired
messagestringrequired
request_idstringrequired

Additional keys: any

5XX500 unexpected failure or 503 unavailable dependency. A failed response does not prove that a submission was not committed. Retry job/flow admission with the same key and body.
X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

errorobjectrequired
Object fields
codestringrequired
messagestringrequired
request_idstringrequired

Additional keys: any