Skip to Content
API ReferenceEvalPOST /create

POST /eval/create

Create Eval

Create evals using composable infra architecture.

Request Body (CreateEvalApiRequest)

FieldTypeRequiredDescription
evalsCreateEvalItem[]YesList of evals to create
idempotency_keystringNoOperation key for ack — promotes or rejects a dormant create
softbooleanNoStage the create dormant (active=False) — propose; the ack ({idempotency_key, accept}) promotes/rejects it
acceptbooleanNoAccept (promote) or reject dormant state. Only meaningful with idempotency_key

Response (CreateEvalApiResponse)

FieldTypeRequiredDescription
resultsEvalResultItem[]YesList of operation results
idempotency_keystringNoIdempotency key echoed back for client correlation
evalsListEvalApiEval[]NoHydrated list rows for the newly-created evals — same shape as /eval/search returns. Used by the client’s ghost rail to materialize the new row from the audit .completed payload without a router refresh. None for soft-pending creates (dormant artifact, hydration runs on ack-accept).
Last updated on