Home
How to use Redox
Manage your Redox setup
Manage user roles

Manage user roles

Last updated: Aug 5, 2026
HEALTH TECH VENDOR
IMPLEMENTATION

A user must have an organization role to participate in a Redox organization. To view or participate in the environments within the organization, a user must have an environment role for each one. Learn more about user roles.

Definitions

Prerequisites

  • A user must be assigned to an organization owner role to manage organization roles.
  • A user must be assigned to either an organization owner or admin role to manage environment roles. Learn more about user roles.

View user roles

  1. Log in to the dashboard.
  2. Click your username at the bottom of the navigation menu.
  3. From the user menu, select the Access Control option.
    The Access Control option is the third option of the user menu.
    Access control option
  4. By default, the Users tab opens with a list of the organization’s users with their corresponding email address and assigned organization role.
    The Users table shows a list of active organization users with their email and organization role.
    View user organization roles
  5. To view a list of a specific user’s assignments, click the three-dots icon in their row.
  6. Select the Edit roles option from the drop-down menu.
    The Edit roles option is the first option in the Action drop-down menu.
    Edit roles option
  7. The user’s role profile opens with all their current organization and environment role assignments.
    The organization and environment role assignments appear at the bottom of the user's profile.
    A user's profile
Different roles for different environments

Remember that a user can have different role assignments in different environments. For example, a user can be assigned to an engineer role in a development environment but an observer role in a production environment. Or, a user might not be assigned an environment role at all (i.e., they have no access to the environment).

Change a user’s organization role

By default, a user is assigned to a member role in a Redox organization. Change a user’s role in their user profile.

  1. Follow the steps to view a user’s roles.
  2. Under the Organization role section, click the Edit button.
  3. From the Current role drop-down, select the organization role you want to assign to this user.
  4. (Optional) Click the View changes option to see a change log summary with how many permissions the user will gain or lose.
  5. Click the Save button. Or click the Cancel button to discard any changes.
    A user's organization role is changed from member to admin to elevate their permissions.
    Change a user's organization role

Change or remove a user’s environment role

  1. Follow the steps to view a user’s roles.
  2. Under the Environment roles section, click the Edit button.
  3. From any of the Current role drop-downs, select the environment role you want to assign to this user. To remove a user’s access to an environment, select the No role assigned option.
  4. (Optional) Click the View changes option to see a change log summary with how many permissions the user will gain or lose.
  5. Click the Save button. Or click the Cancel button to discard any changes.
    A user's environment role is changed from engineer to member in the development environment.
    Change a user’s environment role
Platform API endpoints

This article describes how to manage user roles in the Redox dashboard. To manage user roles via API, use these Redox Platform API endpoints instead:

Just note you can only assign an organization role is by adding a user to an organization in the dashboard. Learn how to add a user.

FHIR® is a registered trademark of Health Level Seven International (HL7) and is used with the permission of HL7. Use of this trademark does not constitute an endorsement of products/services by HL7®.