Update a case reference

Change the client-assigned reference on a case.

Use updateCaseReference to change the client-assigned reference on a case. Set reference to null to clear it.

Required scope: case-management

Request

mutation updateCaseReference($input: UpdateCaseReferenceInput!) {
  updateCaseReference(input: $input) {
    ... on CaseInformation {
      caseId
      reference
    }
    ... on ValidationErrors {
      errors {
        message
      }
    }
  }
}

Variables

{
  "input": {
    "caseId": "48213",
    "reference": "MAT-2026-0214"
  }
}

Response

{
  "data": {
    "updateCaseReference": {
      "caseId": "48213",
      "reference": "MAT-2026-0214"
    }
  }
}

---