Roles

Mintlify provides three dashboard access levels: viewer, editor, and admin.

​

Repository contributors and deployments

Anyone with access to your documentation repository can contribute by pushing changes. However, their changes do not deploy until an editor or admin manually triggers a deployment from your dashboard.

​

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. You can invite any number of members to your organization. Editors and admins can invite editors and viewers. Only admins can invite other admins.

1. Navigate to the Members page of your dashboard.
2. Click Invite members.
3. Enter email addresses in the input field, or paste a list separated by commas, semicolons, spaces, or new lines. You can invite up to 250 addresses at a time. Pro and Enterprise plans can upload a CSV of emails.
4. Click Continue to review the invitees.
5. On the review step, assign a role to each invitee. To change several rows at once, select them and use the bulk role bar.
6. Click Send invites.

Mintlify flags and skips inviting any invalid addresses, duplicates, or people who are already members of your organization.

​

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.
3. Confirm the change.

The new role takes effect the next time the member loads the dashboard.

​

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, click the Remove button.
3. Confirm the removal.

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, click the Revoke credentials button.
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.