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