Notebook permissions

Whether an operation on a notebook is allowed is determined by the workspace role, plus the root folder the notebook belongs to (its access scope). For a feature overview, see Notebook.

Access scope

The access scope is determined by the root folder the notebook is placed in. For how root folder names map to this, also see Folder.

Scope	Description
Workspace	A notebook placed under the "Workspace" root folder. Members can access it according to their workspace role
Teamspace	A notebook placed under the "(teamspace name)" root folder. Access is determined by the teamspace's resource role
Private	A notebook placed under the "Private" root folder. Only the owner, if they're a Workspace Editor or higher, can operate on it
Shared	A notebook placed under a "Shared folder". Who can access it is determined by additional notebook permissions

TIP

The Private, Teamspace, and Shared access scopes are an optional feature. Depending on your contract, they might not be available.

Resource role (when shared)

Roles used for notebooks in the shared scope. Who they're granted to is decided through additional notebook permissions.

Role	Summary
Notebook Editor	Can edit the notebook
Notebook Viewer	Can view the notebook

For notebooks within a teamspace, the teamspace's resource role (Editor / Viewer / Owner) is used for notebook operations.

Operations and required roles

Running SQL and getting execution results on a notebook aren't determined by notebook permissions — they're determined by the permissions of the target connection.

Access scope: Workspace

Notebooks under the "Workspace" root folder. Whether an operation is allowed is determined by the workspace role.

Operation	Required role
Viewing content / commenting	Workspace Viewer or higher
Editing a notebook	Workspace Editor or higher
Moving or deleting a notebook / editing or deleting a folder	Workspace Editor or higher

Access scope: Teamspace

Notebooks under the "(teamspace name)" root folder. Determined by the permissions granted in Teamspace.

Operation	Required role
Viewing content / commenting	Workspace Viewer or higher, and Teamspace Viewer or higher
Editing a notebook	Workspace Editor or higher, and Teamspace Editor or higher
Moving or deleting a notebook / editing or deleting a folder	Workspace Editor or higher, and Teamspace Editor or higher
Sharing with users or groups	Workspace Viewer or higher, and Teamspace Editor or higher

Access scope: Private

Notebooks under the "Private" root folder. Only the owner, if they're a Workspace Editor or higher, can operate on them.

Operation	Required role
Viewing content / commenting	Workspace Editor or higher
Editing a notebook	Workspace Editor or higher
Moving or deleting a notebook / editing or deleting a folder	Workspace Editor or higher
Sharing with users or groups	Workspace Editor or higher

Access scope: Shared

Notebooks under a "Shared folder". Users and groups granted permissions through additional notebook permissions can access them. Notebooks accessed only through sharing can't be deleted or moved, even with edit permission.

Operation	Required role
Viewing content / commenting	Workspace Viewer or higher, and Notebook Viewer or higher
Editing a notebook	Workspace Editor or higher, and Notebook Editor

For the conditions required to publish a report, see Report.