Skip to main content
Manage who can access your organization’s dashboard from the Members page. Each member has a role that controls what they can do.

​
Add members to your organization

By default, the person who creates your Mintlify organization has admin access. Add additional members from the Members page of your dashboard. Starter plans can have up to 5 members. Pro and Enterprise plans can invite any number of members. Editors and admins can invite editors and viewers. Only admins can invite other admins.
  1. Navigate to the Members page of your dashboard.
  2. In New member, enter email addresses, or paste a list separated by commas, semicolons, spaces, or new lines. You can invite up to 250 addresses at a time.
  3. Choose a role. On Enterprise plans, the role defaults to Viewer.
  4. Click Invite.
If every address is new, the invites send right away. If any addresses are invalid, duplicates, or already members or invited, a review drawer opens. Remove rows or change roles, then click Send invites. On Pro and Enterprise plans, use Bulk invite to upload a CSV of emails. Choose a role, click Invite, and review the list before you send the invites.

​
Change a member’s role

Admins can change the role assigned to any member.
  1. Navigate to the Members page of your dashboard.
  2. In the member’s row, select a new role from the Role dropdown. The change saves immediately.
The new role takes effect the next time the member loads the dashboard. You can’t change your own role. If a member’s role comes from SCIM directory sync, their row shows Managed by SSO, and you change their role in your identity provider. If your organization uses expanded roles, the owner’s role can only change if the owner transfers ownership to another member.

​
Transfer ownership

If your organization uses expanded roles, the owner can make another member the owner. Only the owner can see the Owner role in the Role dropdown. The previous owner becomes an admin, and only the new owner can transfer ownership again.
  1. Navigate to the Members page of your dashboard.
  2. In the member’s row, select Owner from the Role dropdown.
  3. In the Transfer ownership? dialog, type TRANSFER to confirm.
  4. Click Transfer ownership.
You can only transfer ownership to an active member. You can’t transfer it to a pending invite or to a member whose role comes from your identity provider.

​
Assign a custom role

If your organization has custom roles, they appear below the built-in roles in the Role dropdown when you invite members, change a member’s role, or change a pending invite’s role. The dropdown lists only the roles whose permissions you have.

​
Delete a custom role

  1. Navigate to the Members page of your dashboard.
  2. In the Custom roles section, open the role’s actions menu and select Delete role.
  3. If members have the role, choose a new role for each of them. Members you don’t change become viewers.
  4. Click Delete permanently.
If a member gets the role from your identity provider, you can’t delete it. Remove the role assignment in your identity provider first.

​
Remove a member

Admins can remove a member from the organization entirely, which deletes their access and any keys they created.
  1. Navigate to the Members page of your dashboard.
  2. In the member’s row, open the actions menu and select Remove member.
  3. Click Remove to confirm.
You can’t remove the owner of an organization that uses expanded roles. To remove them, transfer ownership to another member first. Removing a member deletes the member from your organization. Revoking a member’s credentials signs them out and clears their keys, but keeps their membership.

​
Revoke a member’s credentials

Admins can sign a member out of the dashboard and revoke their keys and tokens without removing them from the organization. Use credential revocation when offboarding someone or responding to a compromised account.
  1. Navigate to the Members page of your dashboard.
  2. In the member’s row, open the actions menu and select Revoke credentials.
  3. Select which credentials to revoke.
  4. Click Revoke.
You can revoke any combination of the following credentials: Revoking credentials cannot be undone. The member can sign in again and create new keys and tokens unless you also remove them from the organization or block their sign-in method. You cannot revoke your own credentials.