Skip to main content
TrueFoundry offers custom roles to be assigned to users with scoped permissions in the platform. These roles allow fine-grained access control over various resources and actions. Key aspects of custom roles:
  1. Each role can have multiple permissions across different resource types
  2. Permissions define what actions can be performed on specific resources
  3. Roles can be assigned to users to grant them the associated permissions

Available Permissions

EntityPermissionDescription
Organization Management & Access Control
AccountCreate AccountAllows creation of new accounts in the tenant
Read AccountAllows viewing all existing accounts in the tenant
Manage AccountAllows editing all existing accounts in the tenant
Delete AccountAllows deleting any existing account in the tenant
RoleList RolesAllows listing and viewing roles
Manage RolesAllows creating, updating, and deleting roles
UserList UsersAllows listing and viewing users
Manage UsersAllows creating, updating, and deleting users
TeamCreate TeamAllows creation of new teams
Delete TeamAllows deleting existing teams
Manage TeamAllows updating team configuration and members
Read TeamAllows viewing team details and members
Virtual AccountList Virtual AccountsAllows listing and viewing virtual accounts
Manage Virtual AccountsAllows creating, updating, and deleting virtual accounts
External IdentityList External IdentitiesAllows listing and viewing external identities
Manage External IdentitiesAllows creating, updating, and deleting external identities
AI Gateway
Provider Account (Models/Guardrails Group)Create Provider AccountAllows creation of new provider accounts
Delete Provider AccountAllows deleting existing provider accounts
Manage Provider AccountAllows updating provider account configuration
Read Provider AccountAllows viewing provider account details
Use IntegrationsAllows using integrations associated with provider accounts
MCP ServerCreate MCP ServerAllows creation of new MCP servers
Delete MCP ServerAllows deleting existing MCP servers
Manage MCP ServerAllows updating MCP server configuration
Read MCP ServerAllows viewing MCP server details
Use MCP ServerAllows using MCP server for operations
Gateway ControlsList Gateway ControlsAllows listing and viewing gateway controls
Manage Gateway ControlsAllows creating, updating, and deleting gateway controls
Tracing ProjectCreate Tracing ProjectAllows creation of new tracing projects
Delete Tracing ProjectAllows deleting existing tracing projects
Manage Tracing ProjectAllows updating tracing project configuration
Read DataAllows reading tracing data
Read Tracing ProjectAllows viewing tracing project details
Write DataAllows writing tracing data
Deployments
ClusterCreate ClusterAllows creation of new clusters
Delete ClusterAllows deleting existing clusters
Manage ClustersAllows updating and configuring cluster settings
Read ClusterAllows viewing cluster details and configuration
WorkspaceCreate WorkspaceAllows creation of new workspaces
Delete WorkspaceAllows deleting existing workspaces
Manage WorkspaceAllows updating workspace configuration
Read WorkspaceAllows viewing workspace details
List WorkspacesAllows listing and viewing all workspaces
ApplicationList ApplicationsAllows listing and viewing applications
Manage ApplicationsAllows creating, updating, and deleting applications
Provider AccountCreate Provider AccountAllows creation of new provider accounts
Delete Provider AccountAllows deleting existing provider accounts
Manage Provider AccountAllows updating provider account configuration
Read Provider AccountAllows viewing provider account details
Use IntegrationsAllows using integrations associated with provider accounts
RepositoryCreate RepositoryAllows creation of new repositories
Delete DataAllows deleting data within repositories
Delete RepositoryAllows deleting existing repositories
Manage RepositoryAllows updating repository configuration
Read DataAllows reading data from repositories
Read RepositoryAllows viewing repository details
Write DataAllows writing data to repositories
EnvironmentList EnvironmentsAllows listing and viewing environments
Manage EnvironmentsAllows creating, updating, and deleting environments
PolicyList PoliciesAllows listing and viewing policies
Manage PoliciesAllows creating, updating, and deleting policies
Others
SettingsList SettingsAllows listing and viewing platform settings
Manage SettingsAllows updating platform settings
Secret GroupCreate Secret GroupAllows creation of new secret groups
Delete Secret GroupAllows deleting existing secret groups
Manage Secret GroupAllows updating secret group configuration
Read DataAllows reading secret values
Read Secret GroupAllows viewing secret group details
Write DataAllows writing or updating secret values

Managing Custom Roles

Manage custom roles with fine-grained permissions on different resources at tenant level. These custom roles can then be assigned to Users.
1

Create custom role

Navigate to Access > Roles. Click on Create Role and select the permissions for the role.
  • Permissions are applied to all the resources in the tenant.
  • Provider Account should be used to give permissions for Models, Guardrails, and Integrations.
2

Assign Roles to user

Navigate to Access > Users. Select the user and click on Edit User. Pick the role and Save Changes.
User can be assigned to only one role at a time.