{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://schemas.kodemed.ch/_common/OpaqueIdentifier.schema.json",
  "title": "KodeMed Opaque Identifier",
  "description": "Partner-controlled identifier — an arbitrary non-blank string up to 100 chars. Used where the value originates from the partner side and is NOT a server-generated UUID: `instanceId` (HIS-supplied idempotency key per submission AND the single correlator across REST request, webhook payload, and WebSocket envelope — last-review feedback dropped a separate `correlationId`), `targetUserId` (HIS-side user identifier for delegated sessions). Distinct from `_common/Identifier` (which IS a strict UUID) so the uniformity test (#640) can keep enforcing UUID format on server-generated *Id fields without forcing partner-supplied ones to fit.",
  "type": "string",
  "minLength": 1,
  "maxLength": 100,
  "examples": [
    "his-session-2026-06-01-001",
    "EOC-CASE-12345"
  ]
}