Skip to main content
PUT
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.

Body

application/json
steps
any[]
required

Steps exactly as the harness wrote them. Stored verbatim and never validated, so a format change needs no gateway release.

schema_version
string
default:ATIF-v1.7

Interchange format of steps. Stored per row so a harness upgrade leaves older trajectories readable.

Required string length: 1 - 32
logs
object | null

Bounded tails of the trial's log files, keyed by their path in the trial dir — trial.log (the harness's own account of the trial), verifier/test-stdout.txt / test-stderr.txt, exception.txt. The harness tails each file before sending; the whole payload still counts against the trajectory size limit.

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
step_count
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
size_bytes
integer
required

Measured from the stored payload, so it describes what was actually written.

Required range: -9007199254740991 <= x <= 9007199254740991