For any enterprise or its workspaces, roles determine what its members can do. Customize your own or use the built-in roles predefined.
Roles define what members can do within your enterprise and its workspaces. In addition to the built-in roles, you can create custom roles with granular permissions tailored to how your organization operates.
Roles exist at two levels, and the two sets of roles are distinct.
Each member has one role at the enterprise level. Within an individual workspace, a member can be assigned a different role that applies only there. A member who is an enterprise Viewer might be a workspace Admin in the one workspace they own, for example.
Seven roles are available by default at the enterprise level.
| Role | Summary |
|---|---|
| Owner | Full control, including deleting the enterprise and managing owners |
| Admin | Everything except deleting the enterprise or assigning the Owner role |
| Compliance Officer | Approves compliance decisions and reads findings and audit activity; cannot author rulesets |
| Ruleset Manager | Authors and publishes enterprise rulesets; reads properties and workspace context |
| Billing Admin | Subscriptions and payment methods only, no product configuration |
| Member | Can create workspaces and view enterprise-level information |
| Viewer | Read-only access to the information they are granted |
Owner has every enterprise permission. Only an Owner can delete the enterprise or grant the Owner role to someone else.
Admin has every enterprise permission except deleting the enterprise, and cannot assign the Owner role. In practice an Admin runs day-to-day administration: managing members and teams, configuring agents, tools, models, integrations, and secrets, and approving staged ruleset changes (enterprise.rulesets.approve) and compliance exceptions (enterprise.compliance.approve), not just viewing them.
Compliance Officer is the compliance governance role. It approves, rejects, and revokes compliance exceptions, decides finding challenges and break-glass reviews, and reads findings and the audit log across every workspace without any workspace content access. It can read rulesets, enterprise properties, and the workspace list so it understands what a decision applies to, but it cannot author or publish rulesets. That separation is deliberate: the people who judge exceptions are not the people who write the standards those exceptions bend.
Ruleset Manager is the standards authoring role. It creates, edits, and publishes enterprise rulesets and their applicability conditions (enterprise.rulesets.manage and enterprise.rulesets.approve), and reads enterprise properties and the workspace list so it can scope a ruleset to the right workspaces. It holds no compliance approval authority, so a Ruleset Manager cannot grant exceptions to the rules they wrote. Give a person both roles through a team grant or a combined custom role when one person genuinely does both jobs.
Billing Admin is a finance-focused role. It can view and manage billing, manage payment methods, and view usage, plus see the member list and browse the templates and modules catalogs so spend can be reconciled against who and what is consuming it. It has no access to enterprise settings, agent or tool configuration, secrets, or integrations.
Member is the standard role for people doing the work. A Member can create workspaces and has read access across most enterprise areas (members, teams, usage, rulesets, compliance, workflows, tools, models, agent configuration, integrations, settings, secret names, templates, and modules) but cannot change enterprise-level configuration. This role replaces the legacy "Editor" enterprise role; existing Editors are migrated to Member automatically.
Viewer is read-only and cannot create workspaces. It can see the member list, teams, usage, compliance state, and the templates and modules catalogs.
When a directory group mapping or an invitation could give one person more than one built-in role, the higher role wins, in this order: Owner, Admin, Compliance Officer, Ruleset Manager, Billing Admin, Member, Viewer. Custom roles never replace a built-in role this way.
Five roles are available by default within a workspace.
| Role | Summary |
|---|---|
| Owner | Full control of the workspace, including deleting it |
| Admin | Manages workspace configuration and membership; cannot delete it |
| Maintainer | Editor capabilities plus workspace rulesets, editable property values, and optional exceptions |
| Editor | Works in the workspace: edits code and docs; no settings or members |
| Viewer | Read-only access to workspace content |
Owner has every workspace permission except central compliance approval and is typically the person who created the workspace. Only an Owner can delete it.
Admin has every workspace permission except deleting the workspace and central compliance approval. Admins manage settings, the target branch, membership, rulesets, compliance, tools, workflows, secrets, and docs.
Maintainer is for the team that owns a workload without owning its membership or settings. It has everything Editor has, plus:
workspace.rulesets.manage and workspace.rulesets.approve). Enterprise rulesets stay with the Ruleset Manager.workspace.properties.manage). Enterprise-controlled values stay read-only.workspace.compliance.exceptions.apply_optional), with a justification recorded under the Maintainer's name.A Maintainer cannot change settings, manage members, or decide anything that needs central approval.
Editor can do the work without changing how the workspace is governed: view and edit content (Terraform code, canvas, plans and applies), manage docs, view and trigger compliance evaluations and submit exceptions for review (workspace.compliance.manage), and view rulesets, tools, workflows, secret names, members, and settings. Editors cannot change settings, manage membership, or approve ruleset or compliance changes.
Viewer has read-only access: view content, rulesets, compliance, tools, workflows, docs, members, and settings.
Exception authority is split by what the rule is, not by who owns the workspace.
workspace.compliance.approve.See Compliance for how requests, grants, and reviews work.
When a workspace is linked to a GitHub repository, enterprise administrators can let the repository's own collaborator permissions grant workspace access. The setting lives in the enterprise Roles settings and applies to every GitHub-linked workspace in the enterprise.
| Setting | What a GitHub collaborator gets |
|---|---|
| Off | Nothing. Only Infracodebase roles grant access. |
| Grant workspace access from GitHub repository permissions | Read or Triage on the repository grants Viewer. |
| Let write access grant Editor | Write, Maintain, or Admin grants Editor; Read or Triage grants Viewer. |
| Let repository administrators grant Maintainer | Admin grants Maintainer; Write or Maintain grants Editor; Read or Triage grants Viewer. |
A few things to know about how this works:
A person's effective permissions in a workspace combine every grant that applies to them: a direct assignment, teams, directory groups, enterprise-level authority (an enterprise Admin can manage every workspace, a Compliance Officer can read every workspace's compliance state), and a linked repository under the setting above.
The workspace Members page explains this. The Your access card at the top lists each grant that applies to you and the combined capabilities they add up to. Your GitHub access is verified live for your own account only, so the card says when that check could not complete. In the members table, each member's role shows the other grants recorded for them, such as a team or enterprise authority, so a role label is never mistaken for the whole picture.
Removing someone's direct assignment removes only that grant. The confirmation names what they keep, or says access ends immediately when there is nothing else.
Permissions are the individual capabilities that make up a role. Each permission belongs to a domain (a feature area), and most domains expose a view permission plus one or more management actions (manage, approve, create, delete).
Enterprise permissions are organized into these domains:
| Domain | What it controls |
|---|---|
billing | Subscription tier, plan changes, and payment methods |
usage | Usage trends and spend breakdowns |
members | Member list, invitations, removals, and role assignment |
settings | Enterprise name, slug, feature flags, and enterprise deletion |
teams | Creating teams and managing team membership |
agent | Agent tool permissions and deny/ask rules |
rulesets | Enterprise rulesets, including approving staged changes |
compliance | Compliance settings, state, and exceptions |
properties | Defining workspace properties and their enterprise values |
tools | Connectors and tool access |
models | Model selection and parameters |
workflows | Workflows available to the enterprise |
secrets | Enterprise-level secrets |
integrations | Version control connections and repository linking |
workspaces | Creating, viewing, managing, and deleting workspaces |
templates | Discovering and promoting workspaces as templates |
modules | Discovering and promoting workspaces as modules |
audit | The enterprise audit log |
tokens | Enterprise access tokens |
Workspace permissions are organized into these domains: settings, members, content, rulesets, compliance, properties, tools, workflows, secrets, and docs.
The rulesets and compliance domains exist at both scopes and carry view, manage, and approve actions. The approve action is separate on purpose: a member can be allowed to draft a ruleset or submit a compliance exception without being allowed to approve it. Workspace compliance adds a fourth action, exceptions.apply_optional, which decides optional-rule exceptions only and never stands in for approve. See Rulesets and Compliance for what those areas govern.
Custom roles let you define exactly what a member can and cannot do. Instead of fitting everyone into one of the built-in roles, you can create roles that match the way your teams actually work.
To create a custom role, go to your enterprise settings and navigate to the Roles section. Give the role a name, a description, and then select the permissions it should have from the domains above. A role can hold any combination of permissions, so you can make it as broad or as narrow as you need.
For example, you might create a "Security Reviewer" role that can view all workspaces and manage and approve rulesets but cannot edit content or change enterprise settings. Or a "Tool Administrator" role that can configure connectors (tools.manage) and manage secrets but has no access to billing or member management. Or a "Standards Lead" role that combines the Compliance Officer and Ruleset Manager permission sets for the one person who does both.
Custom roles appear alongside built-in roles when you invite members or change someone's role, and they work the same way at both the enterprise and workspace level. A custom role always shows under its own name, even when its permissions happen to match a built-in role.
Roles are assigned when you invite a member or from the People page in your enterprise settings.
Role assignment is bounded by what the assigner already holds: you can only grant a role whose permissions are a subset of your own. This prevents privilege escalation: a member with members.roles.assign cannot promote someone into a role that holds permissions the assigner lacks. It is also why only an Owner can grant the Owner role.
The same permission catalog is used by enterprise access tokens, so any permission you can grant to a role can also be stamped onto a token for CI or automation use. Scope tokens to the narrowest set of permissions the job requires. Exception decisions are the one thing a token cannot do on its own: they are recorded under a person's name, so they need a signed-in user or a personal access token.
approve from manage on rulesets and compliance when you want a review step, so one role drafts changes and another approves them.