Custom User Roles - Scopes

29/12/2025

All scopes have the following structure:

{scope_id} - {affected_resource_type}, {affected_app}

Parameter	Description
`scope_id`	name of the scope to be used for defining the role permission
`affected_resource_type`	`GLOBAL/PROJECT`: the scope is relevant for server-wide resource ("`Default Resource`") or for project-resource (by project ID)
`affected_app`	`PPT/GS` - application for which the scope is relevant
`scope_description`	description of the scope purpose
`additional_comment`	some scopes may be not needed and can be marked as deprecated as they are part of legacy parameters and are listed for backward compatibility respectively some scopes are defined, but never used

The table below lists server-related scopes.

Scope	Usage	Details
`remote-systems`	GLOBAL, PPT	Semantic Middleware Configurator / Remote system access. Configure integrations with remote systems.
`migration`	GLOBAL, PPT	Server migration modules access and execution.
`admin:scripts`	GLOBAL, PPT	Access to the Admin Scripts area.
`remote-systems.metadata`	GLOBAL, PPT	Move metadata repositories between remote and local repositories. Deprecated and not used
`corpus-language-model-settings`	GLOBAL, PPT	Change corpus language model settings.
`snapshots:write`	GLOBAL, PPT	Create, delete, and restore snapshots.
`users:create`	GLOBAL, PPT	Create PoolParty users.
`users:read`	GLOBAL, PPT	View/read PoolParty user data.
`users:write`	GLOBAL, PPT	Edit PoolParty user data.
`users:delete`	GLOBAL, PPT	Delete PoolParty users.
`projects:publish`	GLOBAL, PPT; deprecated and not used	Publish/unpublish ontologies and custom schemes.
`ontologies:create`	GLOBAL, PPT	Create ontologies on the Ontology Management dashboard.
`ontologies:read`	GLOBAL, PPT	View ontologies on the Ontology Management dashboard.
`ontologies:write`	GLOBAL, PPT	Edit ontologies on the Ontology Management dashboard.
`ontologies:delete`	GLOBAL, PPT	Delete ontologies on the Ontology Management dashboard.
`projects:create`	GLOBAL, PPT	Create projects.
`projects:delete`	GLOBAL, PPT	Delete existing projects.
`login`	GLOBAL, PPT	Log in to the PoolParty UI.
`apis:read`	GLOBAL, PPT	Use read-only API methods.
`apis:write`	GLOBAL, PPT	Use data-changing API methods.
`wiki:read`	GLOBAL, PPT	Log in as a Wiki user / access Wiki features.
`dashboard`	GLOBAL, PPGS (GraphSearch user)	Access GraphSearch installations as a user. Defined for all user roles, but currently check is performed through the role ("ApiAdmin", "PoolPartyAdmin", "PoolPartySuperAdmin"); backward compatible
`admin.dashboard`	GLOBAL, PPGS (GraphSearch admin)	Manage GraphSearch installations as an administrator. Only the "PoolPartySuperAdmin" role is supported; however currently not in use.

The table below lists project related scopes.

Scope	Usage	Details
`triples:delete`	PROJECT, PPT	Delete triples via the Triples Tab.
`project.users:write`	PROJECT, PPT	Grant project-specific user roles / manage project members.
`project.groups`	PROJECT, PPT	Modify a project group.
`project-events:delete`	PROJECT, PPT	Delete project’s history.
`projects:link`	PROJECT, PPT	Link to projects (project linking capability).
`project-notifications`	PROJECT, PPT	Create, edit, or delete project notification settings.
`project-customschema`	PROJECT, PPT	Modify active custom schemes of a project.
`workflows:configure`	PROJECT, PPT	Change workflow settings.
`workflows:update`	PROJECT, PPT	Approve or reject SKOS Concept and SKOS-XL Label changes (workflow operations).
`workflows:assign`	PROJECT, PPT	Assign workflow items.
`inscheme`	PROJECT, PPT	Change SKOS In Scheme settings.
`skosxl`	PROJECT, PPT	Change SKOS-XL settings.
`collaboration`	PROJECT, PPT	Change concurrent editing (system) settings for collaboration.
`advanced-uri-settings`	PROJECT, PPT	Edit URI settings for newly created project resources (advanced URI settings).
`concepts:change-uri`	PROJECT, PPT	Change URIs of existing resources (URI editing).
`opendata`	PROJECT, PPT	Change Linked Data Administration settings.
`quality-settings`	PROJECT, PPT	Change quality settings.
`projects:advanced-configure`	PROJECT, PPT (currently not used)	Display the Advanced menu; advanced project configuration UI access.
`corpora:create`	PROJECT, PPT	Create corpora in the Corpus Management.
`corpora:read`	PROJECT, PPT	View corpora in the Corpus Management.
`corpora:write`	PROJECT, PPT	Edit corpora in the Corpus Management.
`corpora:delete`	PROJECT, PPT	Delete corpora in the Corpus Management.
`projects:view`	PROJECT, PPT	Baseline access to a project as a resource (provided by default for all projects).
`projects:read`	PROJECT, PPT	Access project content in read-only mode.
`projects:write`	PROJECT, PPT	Edit, delete, or create project data (e.g., concepts).
`classifiers:create`	PROJECT, PPT	Create or duplicate classifiers.
`classifiers:read`	PROJECT, PPT	Access the classifier feature.
`classifiers:write`	PROJECT, PPT	Change classifier settings and run classification tasks.
`classifiers:delete`	PROJECT, PPT	Delete classifier instances.

In this section: