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

Last updated

Was this helpful?