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

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