- Roles set what a person can do across the whole organization.
- Resource grants give extra rights on one connection or agent.
- Groups let you give roles and grants to many people at once.
Built-in roles
What every member can always do
Every member can view, create and share reports, attach files to chats, and see the member list. These rights don’t depend on role and can’t be removed. Editing, deleting or publishing a report is limited to the person who owns it.Custom roles
Custom roles require an Enterprise license.
Resource grants
Resource grants give someone rights on a single connection or agent without making them an admin. On a connection- Manage connection: edit, test, reindex or delete it
- Create agents: build agents on top of this connection
- Manage agents: manage every agent on this connection
- Manage: full owner rights over this agent (includes everything below)
- Manage instructions, Create entities, Manage evals, Manage members
An organization-wide permission, such as Manage instructions, applies to every agent. A Manage grant on one agent covers only that agent.
Groups
Groups require an Enterprise license.
Service accounts
API keys get exactly what their role allows, without the “every member” rights above. New service accounts start with the Member role.Project sharing
Shared projects (report folders) use their own View or Manage access, which you set from the project’s Share dialog rather than in roles.Plan availability
Examples
Analyst who can't see SQL
Analyst who can't see SQL
Create a custom role without View code and assign it instead of Member.
Data owner for one connection
Data owner for one connection
Keep them as a Member and add a Manage agents grant on that connection.
IT admin without data access
IT admin without data access
Create a custom role with only Manage members and Manage identity providers.
