Generated from the OpenAPI contract
sha256:996d7d6160fd0c3c….
How this works.
Evals
4 operations on the Logion v1 API.
- Upload an eval contract (immutable by digest) —
POST /v1/evals/contracts - Get an eval contract by digest or friendly name —
GET /v1/evals/contracts/{ref} - Validate resolved eval inputs before execution —
POST /v1/evals/jobs/validate - Submit an eval result (runner-authenticated) —
POST /v1/evals/results
Upload an eval contract (immutable by digest)
POST /v1/evals/contracts
Validate and store one contract blob.
Validation uses the shared library; the five stable error codes all return 422 and reject before any job row exists.
Operation id: upload_eval_contract
Takes an Authorization header.
Request body
Body UploadEvalContractRequest:
| Field | Type | Required | Notes |
|---|---|---|---|
document |
object | yes | The eval contract document |
name |
string, optional | no | Optional friendly name for the contract |
Responses
| Status | Meaning | Schema |
|---|---|---|
200 |
Contract already existed | — |
201 |
Contract stored | UploadEvalContractResponse |
422 |
Invalid contract | EvalErrorResponse |
Get an eval contract by digest or friendly name
GET /v1/evals/contracts/{ref}
Operation id: get_eval_contract
Takes an Authorization header.
Parameters
| Name | In | Type | Required |
|---|---|---|---|
ref |
path | string | yes |
Responses
| Status | Meaning | Schema |
|---|---|---|
200 |
Contract found | — |
404 |
Unknown contract | EvalErrorResponse |
422 |
Validation Error | HTTPValidationError |
Returns object.
Validate resolved eval inputs before execution
POST /v1/evals/jobs/validate
Operation id: validate_eval_job
Takes an Authorization header.
Request body
Body ValidateEvalJobRequest:
| Field | Type | Required | Notes |
|---|---|---|---|
contract_ref |
string | yes | |
fixture_digests |
object | yes | |
subject_digest |
string | yes |
Responses
| Status | Meaning | Schema |
|---|---|---|
200 |
Successful Response | ValidateEvalJobResponse |
422 |
Invalid eval job | EvalErrorResponse |
Returns ValidateEvalJobResponse:
| Field | Type | Required | Notes |
|---|---|---|---|
contract_digest |
string | yes | |
valid |
boolean | yes |
Submit an eval result (runner-authenticated)
POST /v1/evals/results
Store one normalized eval result.
The request body may never declare contract_standing,
reproduced_by, independence_group, environment_verified
or issuer_id — the reporting runner is the party with the
motive to declare its own result reproduced.
Operation id: submit_eval_result
Takes an Authorization header.
Request body
Body SubmitEvalResultRequest:
| Field | Type | Required | Notes |
|---|---|---|---|
idempotency_key |
string, optional | no | |
result |
object | yes |
Responses
| Status | Meaning | Schema |
|---|---|---|
200 |
Idempotent replay of an existing run | — |
201 |
Result stored | SubmitEvalResultResponse |
401 |
Not a valid runner | EvalErrorResponse |
422 |
Invalid result | EvalErrorResponse |