Last reviewed: 2026-06-20

Account Role Contract

Canonical object: AccountRoleAssignment

Required fields: - id - company_id - account_id - role_key - cardinality - assigned_by_actor_id - assigned_at

Allowed cardinality values: - required_singleton - singleton - repeatable - optional_repeatable

Rules: - Account roles describe stable business meaning, not account numbers. - Singleton roles may be assigned to only one account per company. - Repeatable roles may be assigned to multiple accounts. - Role assignment must not silently duplicate an existing singleton business role.

Related truth pages: - account.contract.md - ../accounting/accounts.md