{"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"roles-and-permissions","__idx":0},"children":["Roles and permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Redocly allows customers to customize access for their organization users (known as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["People"]}," in Redocly) with granular permission levels."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can set roles at two levels in Redocly:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization"]},": When you sign up for a plan with Redocly, you create an organization to access our products via the ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"https://app.redocly.com"},"children":["Workflows"]}," app."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project"]},": A project refers to any API in API registry, Reference docs or Developer portal you create using the ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"https://app.redocly.com"},"children":["Workflows"]}," app."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In one particular organization, users can have one organization-level role and several project-level roles (one per project within an organization)."," ","The same user can have another organization-level role in another organization."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"organization-level-roles","__idx":1},"children":["Organization-level roles"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"https://app.redocly.com"},"children":["Workflows"]},", administrators can set these roles at the organization level for each person in the organization:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Owner"]},": Has permissions to do everything, including inviting people, changing access controls for other members, and closing the organization's account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Member"]}," - By default, has permissions to create new APIs, Reference, and Portals, but is not allowed to change access controls, invite people or manage other organization settings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Participant"]}," - By default, has permissions only to read the APIs, Reference, and Portals."," ","Access is restricted to everything else."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can change default permissions for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Member"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Participant"]}," organization-level role with enterprise plans only. For more details, refer to the ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs-legacy/settings/role-privileges"},"children":["Role privileges"]}," topic."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"organization-level-permissions","__idx":2},"children":["Organization-level permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here is a table highlighting the permissions for these roles at the organization level."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Permission"},"children":["Permission"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Owner"},"children":["Owner"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Member"},"children":["Member"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Participant"},"children":["Participant"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Has access to organization settings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can invite other people (members) to the organization"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can change people (member) roles"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can see other users in the People list"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can see teams and team members"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can see Member invites"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can create new projects"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"project-level-roles","__idx":3},"children":["Project-level roles"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using the ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"https://app.redocly.com"},"children":["Workflows"]}," app, people can be assigned roles at a project level:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Admin"]},": Has permission to do everything across projects they have created, but have limited access to features across other projects where they may just have a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Maintain"]}," role assigned."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Maintain"]}," - Has permission to create new APIs, Reference docs, and Developer portals, but is not allowed to change project settings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Triage"]}," - Has permission to access logs, but is not allowed to change project settings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read"]}," - Has restricted access to projects."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on your role within a project, you have access to specific features in the Workflows app. This is indicated by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Admin"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Maintain"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Triage"]},", or the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," labels displayed on the Projects list."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/project-role-labels-9aa15a43a71e5e7d.png","alt":"Project role labels"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"project-level-permissions","__idx":4},"children":["Project-level permissions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Permission"},"children":["Permission"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Admin"},"children":["Admin"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Maintain"},"children":["Maintain"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Triage"},"children":["Triage"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Read"},"children":["Read"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Registry"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Edit API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manage individual API settings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manage API labels"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View logs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rebuild from branch"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Edit source"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reference docs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View Reference docs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manage Reference docs settings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View production level build"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View preview build"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View logs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer portal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View Developer portal"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manage Developer portal settings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rebuild from branch"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View preview build"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Edit source"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["View builds"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔️"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"map-an-organization-to-a-project-level","__idx":5},"children":["Map an organization to a project level"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Organization level role"},"children":["Organization level role"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default project level role"},"children":["Default project level role"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Owner"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Admin"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Member"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maintain"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Participant"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]}]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An organization ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]}," is considered to have the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Admin"]}," role for every project."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An organization ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Member"]}," is considered to have the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Maintain"]}," role for every project. If an organization ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Member"]}," creates a new project, they will be assigned an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Admin"]}," role for that project."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An organization ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Participant"]}," is considered to have a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," role for every project."]}]}]},"frontmatter":{"excludeFromSearch":true},"tagList":["admonition"],"title":"Roles and permissions","lastModified":"2025-05-28T16:01:32.000Z"}