Skip to Content

POST /eval/draft

Patch Eval Draft

Patch eval draft — composable infra architecture.

Request Body (PatchEvalDraftApiRequest)

FieldTypeRequiredDescription
draft_idstringNoExisting draft UUID to patch
input_draft_idstringNoExisting draft UUID to patch
namestringNoName value to create a resource
name_idstringNoExisting name resource UUID
descriptionstringNoDescription value to create a resource
description_idstringNoExisting description resource UUID
flag_idsstring[]NoSelected flag option UUIDs — canonical; server derives semantics by flag type/value
activebooleanNoDenormalized eval_active flag state; resolved to a flag_ids entry server-side
departmentsstring[]NoDepartment names to resolve
department_idsstring[]NoDepartment UUIDs
model_idsstring[]NoModel UUIDs
model_flag_idsstring[]NoModel flag UUIDs (canonical junction-row ids)
model_flagsobject[]NoInline-create shape for model_flags junction rows: list of {model_id, flag_id} (id=null entries). Resolver upserts the junction row and merges the id into model_flag_ids.
model_flag_valuesEvalModelFlagValue[]NoDenormalized per-(model, type) selections. For each entry the server resolves (type, value) -> flag_id via search_flags, then upserts a model_flags_resource row for (model_id, flag_id) and merges its id into model_flag_ids.
model_position_idsstring[]NoModel position UUIDs
model_rubric_idsstring[]NoModel rubric UUIDs
pending_idsstring[]NoResource IDs to keep inactive on the draft
idempotency_keystringNoOperation key for ack — promotes or rejects a dormant draft
softbooleanNoStage the draft dormant (active=False) — propose; the ack ({idempotency_key, accept}) promotes/rejects it
acceptbooleanNoAccept or reject dormant state. Only meaningful with idempotency_key

Response (PatchEvalDraftApiResponse)

FieldTypeRequiredDescription
successbooleanYesWhether the operation succeeded
draft_idstringYesDraft UUID
idempotency_keystringNoOperation key echoed back for client correlation
messagestringYesHuman-readable result message
form_stateapp__infra__eval__types__DraftFormStateNoServer-authoritative form state
Last updated on