AlmondTill/G3N API

NewContactAssignmentInput

input type

Create-input for a ContactAssignment. The tenant (org group) is derived SERVER-SIDE from the principal; hostId (the parent — rides the header) and contactId are tenant-scoped server-side and must BOTH be ACTIVE (STRICT); the resolved host must actually BE the named hostType; role↔host applicability is checked at the boundary (the ContactRole registry data).

Fields

FieldTypeRequiredNotes
captionStringnoOptional: when omitted the per-type default applies — the role's registry caption (e.g. 'Billing (AP)'); when supplied it must be non-blank.
hostIdID ID!yesThe HOST construct id.
hostTypeContactAssignmentHostType ContactAssignmentHostType!yesThe host's construct class — verified against the resolved host server-side.
contactIdID ID!yesThe assigned Contact id — immutable after birth.
roleString String!yesThe ContactRole token (canned registry — a non-canned or non-applicable role is VALIDATION/INVALID).

Used by