RefCaption

object type

One server-composed reference caption (the referenced-caption rule): the caption of a record THIS record references via a declared ID-class field. A list field answers one row per entry. caption is null when the reference cannot be composed (a foreign-root record — no cross-tenant leak; a dangling id). Provider/system identifiers (Stripe refs, saga locks) never appear — they are declared external.

Fields

Field	Type	Notes
`field`	String `String!`	The referencing field name on the carrying record (e.g. brandId, owners).
`id`	ID `ID!`	The referenced id VERBATIM as the record carries it (a id; the org costCentre answers its sysId).
`caption`	String	The referenced record's caption — null when not composable (foreign root · dangling).
`refType`	String	The DECLARED target construct type of the reference: fixed refs verbatim; a polymorphic ref answers the sibling-resolved type, null when the sibling names nothing. Schema-level knowledge — never data.
`refId`	ID	The referenced construct's id when it DIFFERS from id (a SYSID-storing field — the org costCentre), answered only when the record is readable under your root; null everywhere else (id IS the construct id). Fetch the record by refId when present, else by id.
`reason`	String	WHY caption is null: dangling = the referenced record does not exist (purged, or never did); unreadable = it exists but this session cannot read it (a foreign root — the word never says which). null on a captioned row.