Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omneo.io/llms.txt

Use this file to discover all available pages before exploring further.

Roles in Omneo define the relationship between a customer profile and an organisation. They specify what kind of member the profile is within that organisation.

Role Definitions

Role Definitions are templates that specify:
  • The role name (e.g., “Employee”, “Student”, “Member”, “Director”)
  • The handle (machine-readable)
  • Any associated entitlements or modifiers
Role Definitions are created in CX Manager and managed via the Role Definitions API.

Role Instances

When a profile is linked to an organisation, a Role Instance is created. The instance references:
  • The Profile
  • The Organisation
  • The Role Definition
  • Optional start and end dates (for time-limited roles)
  • Status (active, pending, expired)

How roles are used in incentive logic

Roles can be used as conditions in reactions and benefit eligibility checks. For example:
  • “Issue a 30% benefit to any profile with an ‘Employee’ role in the ‘Acme Corp’ organisation”
  • “Only allow claims of the ‘Supplier Trade’ benefit if the profile has an active ‘Supplier Staff’ role”

Permissions (CX Manager users)

Note: CX Manager user roles (Admin, Manager, Reporting, Machine) are separate from the Organisation Role system. User roles control access to CX Manager features. Organisation Roles define customer profile relationships with external entities. See Accessing CX Manager for CX Manager user role details.