Built-in permission sets and available permissions

Tonic Textual comes with a set of built-in global, dataset, and guided redaction permission sets. You cannot edit or delete the built-in permission sets.

Each permission is assigned Textual permissions. When a new permission is added to Textual, it is also added to the appropriate built-in permission sets.

Built-in global permission sets

Textual comes with the following built-in global permission sets:

• Admin - Provides complete access to all global permissions. The Admin permission set automatically receives any new global permissions.

• Admin (Environment) - For self-hosted only. Identical to the Admin permission set. Only assigned to users and groups listed in the value of the environment variable TEXTUAL_ADMINISTRATORS.

• General User - Allows users to create datasets and custom entity types. Users can also use the Home page and the Request Explorer. By default, the General User permission set is assigned to all Textual users and SSO groups.

Available global permissions

The following tables list the available global permissions, and indicate how the permissions apply to the built-in global permission sets.

Textual API and requests

Permission	General User	Admin and Admin (Environment)
Create an API key	✔️	✔️
Use the playground on the Home page	✔️	✔️
Use the API to parse or redact a text string	✔️	✔️
Use the Request Explorer	✔️	✔️

Configuration management

Permission	General User	Admin and Admin (Environment)
Create custom entity types	✔️	✔️
Edit any custom entity type		✔️

Datasets

Permission	General User	Admin and Admin (Environment)
Create datasets	✔️	✔️
Manage access to datasets		✔️
View all datasets		✔️

Guided redaction

Permission	General User	Admin and Admin (Environment)
Use guided redaction projects	✔	✔
Create guided redaction projects	✔	✔
Control access to all guided redaction projects		✔
View all guided redaction projects		✔
Create redaction reference codes		✔
Edit redaction reference codes		✔
Create guided redaction status values		✔
Edit guided redaction status values		✔

Users and permissions

Permission	General User	Admin and Admin (Environment)
Manage custom permission sets		✔️
Manage access to global permission sets		✔️
View users and groups	✔️	✔️
Manage users and user groups		✔️
View usage metrics		✔️

Built-in dataset permission sets

Textual comes with the following built-in permission sets:

• Editor - A dataset Editor has full access to view, edit, and share access to a dataset. When you create a dataset, you are automatically granted the Editor permission set for that dataset.

• Viewer - A dataset Viewer only has access to view the configuration and to preview and download the results.

Available dataset permissions

The following tables list the available dataset permissions, and indicate how the permissions apply to the built-in dataset permission sets.

General dataset management

Permission	Viewer	Editor
View dataset settings	✔️	✔️
Edit dataset settings		✔️
Share dataset access		✔️
Delete a dataset		✔️

Dataset file management

Permission	Viewer	Editor
Upload files to a dataset		✔️
Start a scan of dataset files	✔️	✔️
Delete files from a dataset		✔️
Preview redacted dataset files	✔️	✔️
Download redacted dataset files	✔️	✔️

Built-in guided redaction permission sets

Textual comes with the following built-in guided redaction permission sets:

• Editor - An Editor has almost full access to a guided redaction project. The one permission an Editor does not have is the permission to review redactions. When you create a project, you are assigned the Editor permission set.

• Viewer - A Viewer can view project settings, change statuses, and review redactions.

Available guided redaction permissions

The following tables list the available guided redaction permissions, and indicate how the permissions apply to the built-in guided redaction permission sets.

General project management

Permission	Editor	Viewer
View project settings	✔	✔
Edit project settings	✔
Share project access	✔
Delete a project	✔

Project file management

Permission	Editor	Viewer
Upload files to a project	✔
Download project files	✔	✔
Delete files from a project	✔
Edit file redactions	✔
Preview project files	✔	✔

Review and collaboration

Permission	Editor	Viewer
Manage comments	✔
Review redactions	✔
View audit log	✔	✔