aVenture APIEntity Relationships

List relationship types

View as Markdown

Returns canonical EntityRelationshipType values, aliases, and policy flags. Use joinable=true values with entities relationships join; acquisitionManaged=true values route through entity acquisitions; exclusiveRelationshipType lists relationship types that cannot coexist for the same unordered entity pair; readOnly=true values are emitted by reads only.

Authentication

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Response

OK
acquisitionManagedboolean
Whether this type must be written through acquisition endpoints.
aliaslist of strings
Accepted aliases that normalize to canonical.
canonicalstring
Canonical relationship type token used in reads and writes.
descriptionstring

Human-readable catalog meaning and placement guidance.

directionenum
How to interpret sourceEntityId and targetEntityId. DIRECTIONAL means sourceRole and targetRole are authoritative.
exclusiveRelationshipTypelist of strings
Relationship types that cannot coexist for one unordered pair.
joinableboolean

Whether generic relationship join/write endpoints accept this type.

pairRulestring
Entity type pairing rule enforced before persistence.
readOnlyboolean
Whether this type is emitted by reads only and rejected on writes.
sourceRolestring or nullOptional

Role of sourceEntityId for directional/type-oriented rows. For affinity this is member.

targetRolestring or nullOptional

Role of targetEntityId for directional/type-oriented rows. For affinity this is provider.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error