> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.umnai.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.umnai.com/_mcp/server.

# Administration

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.](https://files.buildwithfern.com/umnai.docs.buildwithfern.com/df4edc101137a64d3a3755a156f2641b1920deab005b9feb5e551f2da2014bd9/assets/images/organisation-accounts-relationship.png)

![Users can belong to an organisation and one or more accounts.](https://files.buildwithfern.com/umnai.docs.buildwithfern.com/0ef8011cd605fd4dfb93efe18b6c794bd44028757796cf4472e839b29563e2b0/assets/images/user-membership-organisation-accounts.png)

## 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.](https://files.buildwithfern.com/umnai.docs.buildwithfern.com/170ed43c05dca78c24ce163985dd7202c89f47b7a011bcc1924965c57f408c99/assets/images/administration-user-access-overview.png)

## Administration guides

| Area                                                                                                                                | Covers                                                                                          |
| ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| [Access control](/guides/administration/access-control-and-permissions)                                                             | Identity scope, roles, and when to use user-scoped or account-scoped credentials.               |
| [Organisations](/guides/administration/organisation) and [accounts](/guides/administration/account)                                 | Organisation and account access, including the account-level boundaries for platform resources. |
| [Users](/guides/administration/user) and [roles](/guides/administration/role)                                                       | User retrieval, user invitations, and the roles available for assignment.                       |
| [Profile](/guides/administration/profile-and-settings/profile) and [settings](/guides/administration/profile-and-settings/settings) | Current-user details, active account selection, and user-level settings.                        |