API referenceRuns
Get a run's pack trace.
Errors return a
{ message, code }body — see the error reference for thecode→ SDK exception map.
GET
/v1/runs/{id}/traceReturns the run's context-pack history newest-first — one entry per pack built for the run, with the query, coverage, freshness, timing, and the memory ids that composed it. It is the audit substrate for reviewing what a run saw; comparing two entries (a diff) is a client concern. Keyset- paginated via cursor. Scoped to the API key's project; an unknown run (or one in another project) is a 404.
Authorization
bearerAuth AuthorizationBearer <token>
API key sent as a bearer token: Authorization: Bearer <key>.
In: header
Path Parameters
id*string
Format
uuidQuery Parameters
limit?integer
Maximum pack entries to return (capped at 200).
Range
1 <= value <= 200Default
50cursor?string
Opaque keyset cursor from a previous response's next_cursor.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/trace"{ "packs": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "created_at": "2019-08-24T14:15:22Z", "query": "string", "covered_seq": 0, "freshness_lag_ms": 0, "latency_ms": 0, "memory_ids": [ "eb7534a5-cee5-42bd-8ebf-a90c5c966568" ], "pack_hash": "string" } ], "has_more": true, "next_cursor": "string"}{ "message": "string", "code": "string"}{ "message": "string", "code": "string"}