CriterionView
A criterion with its evidence reassembled — what a client renders.
Shape
- created_atstring
- criterion_idCriterionId (string · uuid)The criterion's identifier. It never changes, so rewording or re-binding a criterion keeps its identity and its evidence.
- issue_uidIssueUid (string · uuid)
- satisfiedboolean
- stateCriterionStateunverifiedpassingfailingstalemanualA criterion's verdict.
- textstringThe human statement — the criterion's title. The label, not the identity.
- updated_atstring
- binding_exprstring or nulloptionalThe binding's
@-expression, as written. Absent for a manual criterion. - binding_keystring or nulloptionalThe normalised form of
binding_expr, which two equivalent spellings share. Absent for a manual criterion. - checkedbooleanoptionalWhether the box is ticked. Meaningful only for a manual criterion — a bound one is ticked by its
state, and ticking it by hand is refused with a409. - descriptionstring or nulloptionalAn optional longer description (markdown) — the per-criterion detail a flat checkbox could never hold.
evidenceEvidence or nulloptional
- The Evidence schema
- commit_shaCommitHash (string)
- observed_atstringWhen the run that produced the evidence finished, RFC 3339.
- pipeline_idPipelineId (string · uuid)
- pipeline_run_idPipelineRunId (string · uuid)
- node_run_idNodeRunId (string · uuid) or nulloptional
- valuenumber · double or nulloptional
- facet_categoryFacetCategory (string) or nulloptional
- facet_keyFacetKey (string) or nulloptionalThe blueprint facet this criterion belongs to, when a blueprint added it. Absent for a criterion written directly. A facet's state is rolled up from the criteria carrying its key.
- last_evidence_atstring or nulloptional
- last_evidence_commit_shaCommitHash (string) or nulloptional
- last_evidence_node_run_idNodeRunId (string · uuid) or nulloptional
- last_evidence_pipeline_idPipelineId (string · uuid) or nulloptionalThe pipeline whose run last provided evidence for this criterion. Only a later run of the same pipeline can make the criterion
stale. - last_evidence_run_idPipelineRunId (string · uuid) or nulloptional
- last_evidence_valuenumber · double or nulloptionalThe observed value, for a
MetricorCoveragebinding. - ordinalinteger · int32optional0–∞Position in the description, so the list round-trips in authoring order.
- required_for_closebooleanoptional
@optionalopts out. Everything else in a Definition of Done is required by definition.
Example
Synthesized example{
"created_at": "2026-10-12T07:33:47Z",
"criterion_id": "b39e6f4b-3fd0-42ea-b604-59ec47c9d9d7",
"issue_uid": "21a9b81e-724e-465f-b7d7-3baeb9694f4c",
"satisfied": false,
"state": "unverified",
"text": "text-5c91",
"updated_at": "2026-10-11T18:53:40Z",
"binding": {
"kind": "test",
"test_id": "71dcda86-fd88-4fbb-81b5-3043d78f862b",
"suite": "suite-2204"
},
"binding_expr": "binding-expr-66d2",
"binding_key": "binding-key-fa62",
"checked": false,
"description": "Renders each region as density contours of its operations.",
"evidence": {
"commit_sha": "3e8c9b4fe7f216b817afb0c5976d760415e4f3e5",
"observed_at": "2026-10-13T15:35:43Z",
"pipeline_id": "1e1803e6-4cc4-4f89-a0c4-3344205625d0",
"pipeline_run_id": "9e2b7c41-3d5a-4f8e-b1c2-7a6d5e4f3c2b",
"node_run_id": "b342d4fb-eafc-4a32-bd7a-0546a5dbfc2b",
"value": 49
},
"facet_category": "facet-category-7646",
"facet_key": "facet-key-0496",
"last_evidence_at": "2026-10-12T20:49:41Z",
"last_evidence_commit_sha": "481ef59c9800aeb5bcd88bc4a586d0aaa8ee7b87",
"last_evidence_node_run_id": "91b48a87-1ed2-475d-9f02-00fd671195ca",
"last_evidence_pipeline_id": "88ee21c3-d7c5-4a91-95d0-28273f3f02d4",
"last_evidence_run_id": "9e2b7c41-3d5a-4f8e-b1c2-7a6d5e4f3c2b",
"last_evidence_value": 15,
"ordinal": 37,
"required_for_close": false
}
Graph
Contains
Used by
Sent by 0 operations
No operation takes it as a request body.
Returned by 7 operations
- POSTApply a custom type's facets to an existing work item/repositories/{repo_id}/issues/{issue_id}/apply-blueprint
- GETList a work item's acceptance criteria/repositories/{repo_id}/issues/{issue_id}/criteria
- POSTAdd an acceptance criterion to a work item's Definition of Done/repositories/{repo_id}/issues/{issue_id}/criteria
- PUTReorder a work item's acceptance criteria/repositories/{repo_id}/issues/{issue_id}/criteria/order
- PATCHEdit an acceptance criterion/repositories/{repo_id}/issues/{issue_id}/criteria/{criterion_id}
- GETThe suspect commits behind a regression — the last-green→first-red range, one of which broke it/repositories/{repo_id}/issues/{issue_id}/regression
- GETThe Proof-of-Done view — every criterion, its state, and the evidence that produced it/repositories/{repo_id}/issues/{issue_id}/verification