Skip to content

Permissions and roles reference

This reference describes the access levels and permissions available within DocuBot. Use this guide to understand how roles govern your ability to manage documentation sites, connect repositories, and configure synchronization settings.

User roles

DocuBot uses three primary roles to manage access to the dashboard and the generated documentation.

RoleDescription
OwnerThe individual who creates the documentation site. Owners have full administrative control over the site configuration, repository sources, and billing settings.
Authorized UserA user who has been granted access to the DocuBot dashboard. These users can manage repositories and trigger updates based on the organization’s allowlist requirements.
Public ViewerAny external user who accesses the published documentation URL. Viewers can read all generated content and download PDF exports but cannot access the dashboard or configuration settings.

Permissions matrix

The following table outlines the specific actions available to each role within the platform.

ActionOwnerAuthorized UserPublic Viewer
Create documentation sitesYesYesNo
Delete documentation sitesYesNoNo
Connect GitHub repositories via OAuthYesYesNo
Configure sync schedules and frequenciesYesYesNo
Trigger manual documentation rebuildsYesYesNo
Modify audience and document type selectionsYesYesNo
View generated documentationYesYesYes
Download PDF exportsYesYesYes

Access and authorization

DocuBot relies on secure, industry-standard authentication methods to verify your identity and protect your repository data.

Account authentication

You must sign in to the DocuBot dashboard using Google Sign-In. Access to the workspace is governed by a domain-based allowlist. If your email domain is not on the authorized list, you will not be able to access the dashboard even after a successful Google sign-in.

Repository access

To generate documentation from private repositories, you must authorize DocuBot via GitHub OAuth. This connection allows DocuBot to securely retrieve your code for the purpose of documentation generation. Public repositories do not require this authorization.

Limitations

Granular team-based permissions or sub-administrator roles are not currently available. All authorized users within a workspace share the same management capabilities for the repositories they track.

Contact support

If you need to adjust your domain allowlist or require assistance with role assignments, please contact our support team: