Roles

Assign admin, editor, or viewer roles to team members to control access levels, editing permissions, and deployment capabilities in Mintlify.

Role-based access control (RBAC) is available on Enterprise plans.

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

	Viewer	Editor	Admin
View content in the editor	✅	✅	✅
View dashboard and analytics	✅	✅	✅
Ask the Slack agent questions	✅	✅	✅
Make changes with the Slack agent	❌	✅	✅
Edit content in the web editor	❌	✅	✅
Publish changes	❌	✅	✅
Create, rename, and delete pages	❌	✅	✅
Reorder navigation	❌	✅	✅
Upload media	❌	✅	✅
Trigger deployments	❌	✅	✅
Create and delete API keys	❌	✅	✅
Configure integrations	❌	✅	✅
Configure assistant	❌	✅	✅
Configure add-ons	❌	✅	✅
Invite editors and viewers	❌	✅	✅
Update user roles	❌	❌	✅
Invite admins	❌	❌	✅
Delete users	❌	❌	✅
Manage billing	❌	❌	✅
Manage SSO	❌	❌	✅
Update custom domain	❌	❌	✅
Update Git source	❌	❌	✅
Delete organization	❌	❌	✅

Limit admin access to only the people who need to perform admin tasks.

Add members to your organization

By default, the person who creates your Mintlify organization has admin access. Add additional members in the Members page of your dashboard.

You can invite any number of members to your organization.

Change a member’s role

Admins can change the role assigned to any member.

Navigate to the Members page of your dashboard.
In the member’s row, select a new role from the role dropdown.
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.

Navigate to the Members page of your dashboard.
In the member’s row, click the Remove button.
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.

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.

Navigate to the Members page of your dashboard.
In the member’s row, click the Revoke credentials button.
Select which credentials to revoke.
Click Revoke.

You can revoke any combination of the following credentials:

Credential	What revoking it does
Sessions	Signs the member out of the dashboard.
CLI tokens	Signs the member out of the CLI.
API keys	Deletes the API keys that the member created.
Discovery API keys	Deletes the discovery API keys that the member created.
M2M clients	Revokes the member’s machine-to-machine client credentials.
Connected apps	Disconnects the apps the member authorized through OAuth.

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.

Add members to your organization

Change a member’s role

Remove a member

Revoke a member’s credentials

On this page