IssueVerificationResponse
The Proof-of-Done view: every criterion, its state, and the evidence that produced it.
Shape
criteriaarray of CriterionView
- The CriterionView schema
- 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.
summaryCriteriaSummary
- The CriteriaSummary schema
- requiredinteger · int320–∞Of the
required_for_closeones — the set that actually gatesVerifiedand a close. - required_satisfiedinteger · int320–∞
- satisfiedinteger · int320–∞
- totalinteger · int320–∞
- uidIssueUid (string · uuid)
- verificationVerificationStateunverifiedverifiedregressedWhether CI has proved the work item's acceptance criteria.
unverifieduntil a pipeline run proves them,verifiedonce one has, andregressedwhen a later run shows that evidence no longer holds. facetsarray of FacetRollupoptionalThe criteria grouped by blueprint facet, each with its overall state. Absent for an item filed as a built-in type; present for one filed as a custom type.
- The FacetRollup schema
- criterion_idsarray of CriterionId (string · uuid)The criteria under this facet, in ordinal order.
- facet_keyFacetKey (string)
- requiredbooleanWhether any criterion under the facet gates close.
- satisfiedbooleanGreen iff every required criterion under the facet is satisfied — the same set the merge gate keys on, so the rollup is presentational and never a second source of truth.
- facet_categoryFacetCategory (string) or nulloptional
- regressed_atstring or nulloptional
- regressed_from_shaCommitHash (string) or nulloptional
- regressed_run_idPipelineRunId (string · uuid) or nulloptional
- verified_atstring or nulloptional
- verified_at_shaCommitHash (string) or nulloptional
- verified_run_idPipelineRunId (string · uuid) or nulloptional
Example
Synthesized example{
"criteria": [
{
"created_at": "2026-10-11T02:16:31Z",
"criterion_id": "7028dc4f-8f2d-4c63-bedf-425a54979736",
"issue_uid": "30ffba73-576f-4f59-8b45-03e6794ea1ee",
"satisfied": false,
"state": "unverified",
"text": "text-1539",
"updated_at": "2026-10-08T12:00:23Z"
}
],
"summary": {
"required": 0,
"required_satisfied": 78,
"satisfied": 32,
"total": 6
},
"uid": "0cb802bd-6a1b-42be-98c5-a0d55617a56f",
"verification": "unverified",
"facets": [
{
"criterion_ids": [],
"facet_key": "facet-key-9ef1",
"required": false,
"satisfied": false
}
],
"regressed_at": "2026-10-09T03:36:06Z",
"regressed_from_sha": "a5a12b487828ef01c91a702f5f5314031f3fc2bd",
"regressed_run_id": "9e2b7c41-3d5a-4f8e-b1c2-7a6d5e4f3c2b",
"verified_at": "2026-10-17T07:45:36Z",
"verified_at_sha": "76b5633da62ca92066fbc95921cfd670cea565ec",
"verified_run_id": "9e2b7c41-3d5a-4f8e-b1c2-7a6d5e4f3c2b"
}
Graph
Used inside
No schema contains this one.
Used by
Sent by 0 operations
No operation takes it as a request body.