Skip to content
GitmoapAPIBeta
Schema

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
    • bindingCriterionBinding or nulloptional
    • 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 a 409.
    • 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 Metric or Coverage binding.
    • ordinalinteger · int32optional0–∞Position in the description, so the list round-trips in authoring order.
    • required_for_closebooleanoptional@optional opts out. Everything else in a Definition of Done is required by definition.
  • summaryCriteriaSummary
    • The CriteriaSummary schema
    • requiredinteger · int320–∞Of the required_for_close ones — the set that actually gates Verified and a close.
    • required_satisfiedinteger · int320–∞
    • satisfiedinteger · int320–∞
    • totalinteger · int320–∞
  • uidIssueUid (string · uuid)
  • verificationVerificationStateunverifiedverifiedregressedWhether CI has proved the work item's acceptance criteria. unverified until a pipeline run proves them, verified once one has, and regressed when 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