Skip to main content
GET
Python (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Path Parameters

run_id
string
required
sample_index
integer
required
Required range: 0 <= x <= 2147483647

Query Parameters

task_id
string

Disambiguate the sample index, which is unique per (task, model) and not per run. Required when the index matches trials from more than one task.

model
string

Disambiguate the sample index when the run covers more than one model.

Response

200 - application/json

OK

object
any
required
run_id
string
required
sample_index
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
task_id
string
required
model
string
required
schema_version
string
required

Interchange format of steps, e.g. ATIF-v1.7. Read it before assuming a step shape.

step_count
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
size_bytes
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
steps
null[]
required

Steps exactly as the harness wrote them — reasoning_content, tool_calls[{ function_name, arguments }], observation.results[{ source_call_id, content }]. Passed through unvalidated so a harness upgrade does not need a gateway release.

logs
object | null
required

Bounded tails of the trial's log files, keyed by their path in the trial dir (trial.log, verifier/test-stdout.txt, ...). Null for trials recorded before logs were captured.