Skip to Content
API ReferenceEvalPOST /update

POST /eval/update

Update Eval

Update evals using composable infra architecture.

Request Body (UpdateEvalApiRequest)

FieldTypeRequiredDescription
evalsUpdateEvalItem[]NoList of evals to update (required on first call when all is false)
allbooleanNoWhen true, apply patch to every eval matching the filter fields below (minus excluded_ids)
excluded_idsstring[]NoUUIDs to skip even when matched by all-mode filters
patchUpdateEvalPatchNoShared change set applied to every matched row when all=true (sparse — only set fields are updated; patch.id ignored)
searchstringNoFull-text search query
filter_department_idsstring[]NoFilter by department UUIDs
department_searchstringNoSearch text for department facet (no-op for row filtering)
flag_searchstringNoSearch text for flag facet (no-op for row filtering)
idempotency_keystringNoOperation key for ack — promotes or rejects a dormant update
softbooleanNoStage the update dormant (active=False) — propose; the ack ({idempotency_key, accept}) promotes/rejects it
acceptbooleanNoAccept (promote) or reject dormant state. Only meaningful with idempotency_key

Response (UpdateEvalApiResponse)

FieldTypeRequiredDescription
resultsEvalResultItem[]YesList of operation results
idempotency_keystringNoIdempotency key echoed back for client correlation
evalsListEvalApiEval[]NoHydrated list rows for the updated evals — same shape as /eval/search returns. Used by the client’s ghost rail to materialize the changed row from the audit .completed payload without a router refresh. None for soft-pending updates.
Last updated on