Administration

Manage account access, users, roles, and user-level settings.

View as Markdown

Administration in the platform centres on how teams organise access to platform resources.

Most administration tasks happen around accounts. Accounts sit under an organisation and contain the resources your team works with, including data, models, configurations, and workspaces.

Organisations and accounts are currently created by Umnai during onboarding. In the API, administration endpoints let you retrieve the organisations and accounts available to your credentials, manage access, and work within those account boundaries.

Users can belong to one or more accounts. Their effective access depends on the identity used to make a request and the roles associated with that identity.

Organisations contain one or more accounts.

Organisations contain one or more accounts.

Users can belong to an organisation and one or more accounts.

Users can belong to an organisation and one or more accounts.

Access and roles

Access is shaped by both the credential used and the roles assigned to that identity.

Account credentials are scoped to a single account. User credentials act on behalf of a user and can access the organisations and accounts available to that user, subject to their roles.

Roles are visible and assignable, but role and permission management is not yet fully exposed. You can retrieve available roles and assign role IDs when inviting users.

Users and credentials are governed by roles and permissions.

Users and credentials are governed by roles and permissions.

Administration guides

AreaCovers
Access controlIdentity scope, roles, and when to use user-scoped or account-scoped credentials.
Organisations and accountsOrganisation and account access, including the account-level boundaries for platform resources.
Users and rolesUser retrieval, user invitations, and the roles available for assignment.
Profile and settingsCurrent-user details, active account selection, and user-level settings.