{"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"role-privileges","__idx":0},"children":["Role privileges"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Any user in Workflows has an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Member"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Participant"]}," organization-level role assigned to them. For more details, refer to the ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs-legacy/people/roles-permissions"},"children":["Roles and permissions"]}," topic."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["People with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]}," role can change default privileges for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Member"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Participant"]}," roles, including the ability to view top-level tabs and create new content (APIs, references and portals) within these tabs."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Setting up and changing role privileges is only available to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enterprise"]}," customers. For all non-enterprise organizations, the role privileges are set by default and are not editable."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are currently four tabs (other than ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]},"), available in the Workflows app:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API Registry"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Portals"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["People"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Teams"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Changing any privilege affects displaying these tabs or related content and buttons inside these tabs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-configure-role-privileges","__idx":1},"children":["How to configure role privileges"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Log in to Workflows, and navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Role privileges"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/role-privileges-location-53832db87e5d27ca.png","alt":"Role privileges"},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select/deselect ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["view"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create"]}," checkboxes for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Participant"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Member"]}," roles."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," to confirm your changes."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Role privileges are hierarchical."," ","The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create"]}," privilege requires the corresponding ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["view"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read"]}," privileges."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"read","__idx":2},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read"]}," privilege allows you to make a particular project type accessible or inaccessible to users when it is protected by authorization."," ","If deselected for a project type (API registry, Portals), users will not be able to log in to access those projects regardless of any project-level permissions assigned to them."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you remove ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read"]}," privilege for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API registry"]}," for some role, users with this role will not be able to log in to API docs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you remove ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read"]}," privilege for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Portals"]}," for some role, users with this role will not be able to log in to portals."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"view","__idx":3},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["view"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["view"]}," privilege allows you to hide or show a particular tab."," ","If deselected, the tab is hidden from view, regardless of any project-level permissions assigned to user."," ","All other content related to deselected privilege is also hidden in all other tabs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you remove ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["view"]}," privilege for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API registry"]}," for some role, users with this role will not be able to see links to API docs from the API overview page."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you remove ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["view"]}," privilege for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["People"]}," for some role, users with this role will not be able to see any info related to people on any page."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create","__idx":4},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create"]}," privilege controls the ability to add new content."," ","If deselected, all buttons related to creating content will be hidden (APIs, Portals)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you remove the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create"]}," privilege for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API registry"]}," for some role, users with this role will not be able to create new API versions."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"restore-default-settings","__idx":5},"children":["Restore default settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To restore privileges to default settings, select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Restore default settings"]}," button and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"examples","__idx":6},"children":["Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"view-api-registry-privilege","__idx":7},"children":["View API registry privilege"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To hide the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API registry"]}," tab for people with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Member"]}," role, deselect the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["view"]}," checkbox for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Member"]}," column in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API registry"]}," row and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/api-registry-view-privilege-9ea8651a8f1dcec6.png","alt":"Deselect view API registry"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create"]}," privilege will be automatically deselected due to privilege hierarchy."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Result of the modified ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Member"]}," role"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The API registry tab is not displayed in Workflows."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/no-api-registry-tab-86a320deb9379f40.png","alt":"API registry tab hidden"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"view-people-privilege","__idx":8},"children":["View people privilege"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To make user accounts with project and direct access visible on the Reference settings page to users with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Participant"]}," role, select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Participant > People"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["view"]}," checkbox."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/participant-view-people-privilege-f72d3018171923cc.png","alt":"Select view People"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Result of the modified ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Participant"]}," role"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Participants can see people in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project access"]}," section. Participants with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Admin"]}," base or project role can also see the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage direct access"]}," section."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/show-ref-manage-access-0dc27864ecede2e7.png","alt":"Show manage access options"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you deselect the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["view"]}," privilege for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Member"]}," in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["People"]}," row, they will only see the Docs access options."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/ref-no-people-access-9505dc1e5068158b.png","alt":"Hide manage access options"},"children":[]}]}]},"frontmatter":{"excludeFromSearch":true},"tagList":["admonition"],"title":"Role privileges","lastModified":"2025-05-28T16:01:32.000Z"}