RelationshipAssertions
What each source says a relationship is, before the platform resolves them into one link.
Assert a relationship from a source system
Records that a source system says two things are related, identified by their natural keys rather than by platform ids. The platform resolves those keys to records itself, so a feed can describe relationships without knowing anything about internal identifiers. If the far side has not arrived yet the assertion waits rather than failing. Requires `relationship-assertion.create`.
List relationship assertions
Returns assertions with their state — resolved, waiting for the other side, or ambiguous because a key matched more than one record. The unresolved ones are a steward's queue. Requires `relationship-assertion.read`.
Preview how an assertion would resolve
Shows which record a natural key would resolve to, and whether it is unambiguous, without recording anything. Use it when a feed's keys are not resolving as expected. Requires `relationship-assertion.read`.
Get a relationship assertion
Returns one assertion with the keys it carries and what they resolved to. Requires `relationship-assertion.read`.
Resolve an ambiguous assertion
Chooses which record an ambiguous key refers to, and creates the relationship. Requires `relationship-assertion.resolve`.
Reject an assertion
Records that this asserted relationship should not exist. The decision is remembered, so the same assertion does not return to the queue. Requires `relationship-assertion.resolve`.
Reopen a resolved assertion
Returns a settled assertion to the queue, for when the decision turns out to have been wrong. Requires `relationship-assertion.resolve`.