{"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"manage-access","__idx":0},"children":["Manage access"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on your plan (and ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs-legacy/people/roles-permissions"},"children":["role"]},", people with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]}," role (at the organization level) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Admin"]}," role (at the project level) can control access to API registry versions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"set-up-access-to-api-registry","__idx":1},"children":["Set up access to API registry"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to your organization in ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"https://app.redocly.com/"},"children":["Workflows"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API registry"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["From the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API registry"]}," page, select the ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs-legacy/api-registry/guides/manage-versions"},"children":["API version"]}," for which you want to control access. The selected API details display."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," tab to view the API registry settings for that version."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["From the left menu, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage access"]},"."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/versions-manage-access-f5ebfc6451f90d30.png","alt":"Versions - Manage access"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Manage Access"]}," page displays the following information:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Registry access"]},": Indicates whether the API registry version is protected by access controls or available to the public."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Base role"]},": You can set base permissions that apply to all members of an organization when accessing any of the organization's API registry versions. By default, members of an organization will have ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Maintainer"]}," permissions to the organization's API registry versions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Direct access"]},": Displays who outside your organization has access to your API registry version. You can invite a member (not currently part of your organization) to collaborate on your API registry."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage direct access"]},": You can use this section to add, remove or edit collaborators for the selected API registry version."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"manage-collaborators","__idx":2},"children":["Manage collaborators"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["People with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]}," role for an organization (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Admin"]}," role on a project) can add outside collaborators or teams to a project, unless an organization ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]}," has restricted the ability to invite collaborators."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you select a collaborator or a team, they will get direct access to the API registry version."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you select a team for collaboration, all users that are part of the team will automatically become collaborators on the selected project unless they have a lower role such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Triage"]},". A person's base role overrides any team roles."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage access"]}," section, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select a Collaborator/Team"]},"."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/select-collaborator-530a8dc40ef2e62f.png","alt":"Select a collaborator"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["From the dropdown, search by name or email to select a collaborator/team."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a member or team does not display in the dropdown, you can add a new member or team from this dialog. You are redirected to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Teams"]}," page as selected."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the project-level role you want to assign to the collaborator/team, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/select-collaborator-role-62cbbce0dd2c2fd2.png","alt":"Select a collaborator role"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information, refer to our ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs-legacy/people/roles-permissions#project-level-roles"},"children":["Project-level roles"]}," topic."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The member details are now displayed in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage access"]}," section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Direct access"]}," tile is updated to display the number of people who have direct access to the API version."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/direct-access-updated-8c510e14a4f40cc0.png","alt":"Updated collaborator details"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"add-a-collaborator-not-currently-in-your-organization","__idx":3},"children":["Add a collaborator not currently in your organization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you want to add a collaborator who is not currently a part of your organization, you will need to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["add/invite a new member to your organization"]},". Once they have accepted your invitation and logged in using the invitation link, you can add them as a collaborator, and assign them a relevant project-level role."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To invite a new member to your organization, see the ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs-legacy/workflows/manage-access"},"children":["Managing access to Workflows"]}," topic."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update-collaborator-role","__idx":4},"children":["Update collaborator role"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["People with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]}," role for an organization (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Admin"]}," role on a project) can update a collaborator's role on a project in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage access"]}," section."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage access"]}," section, select the collaborator whose role you want to update, and under Role, select the role you want to assign to the collaborator."," ",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/update-collaborator-role-c612216c71a57956.png","alt":"Update collaborator role"},"children":[]}," ","The collaborator role and permissions are immediately updated for the selected project."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"delete-collaborators-from-version-projects","__idx":5},"children":["Delete collaborators from version projects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["People with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]}," role for an organization (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Admin"]}," role on a project) can delete collaborators to a project in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage access"]}," section."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage access"]}," section, select the collaborator you want to delete, and select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete"]}," icon."," ","A confirmation dialog displays."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Remove collaborator"]}," dialog, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete"]},".",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The collaborator details are removed from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage access"]}," section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Direct access"]}," tile is updated to display the number of people who have direct access to the version project."]}]}]}]}]},"frontmatter":{"excludeFromSearch":true},"tagList":["admonition","partial"],"title":"Manage access","lastModified":"2025-08-10T02:58:02.000Z"}