Skip to content

User roles

A person's role decides what they can do in the archive. Every protected action checks the user's role against a minimum required role. Roles are strictly ordered, so a higher role can do everything a lower one can.

The role hierarchy

Roles are ranked by privilege level. A request is allowed when the user's level is greater than or equal to the level the action requires.

Level Role Summary
0 Researcher Read-only access. Can submit triage content.
1 Author Can create objects. Can edit/delete only their own.
2 Reviewer Can edit any object. Can delete only their own.
3 Editor Can create/edit/delete any object.
4 Supervisor Editor + user management, object locking, comment moderation, and copyright/DMCA status changes.
5 Administrator Full system access (admin GUI users).
6 System Internal automation only, no GUI access. Ranks above Administrator (for example, only System can flag an object as Error).

Ownership rules

For object-level actions, role is combined with ownership of the resource:

Action Any resource Own resource only
Edit Reviewer and above Author
Delete Editor and above Author, Reviewer

_

A locked object is exempt from these rules: once locked, only a Supervisor (or higher) can edit or delete it, regardless of ownership. See Object flags.

Permissions by resource

Minimum role required per operation. Public means no authentication is required (anonymous access).

Account & settings

Authentication is stateless: the archive trusts a bearer token issued by your organization's login provider, so there are no in-app sessions or passwords. See Authentication for the technical model.

Operation Minimum role
Version info Public
Server context Public
List permissions Researcher
Read own profile Researcher
Own permissions Researcher
Read own settings Researcher
Update own settings Researcher

Items

Operation Minimum role
List / read / stats Public
Featured / manifest Public
Orphaned (+ stats) Author
Create / update / delete Author (+ ownership)

Item sets

Operation Minimum role
List / list all / read Public
Stats / featured / manifest Public
Create / update / delete Author (+ ownership)

Media

Operation Minimum role
List / read / stats / manifest Public
Original / thumbnail Public
Orphaned (+ stats) Author
Create / upload / upload from URL Author
Replace / replace from URL Author
Update / delete Author (+ ownership)
Check hashes / update hashes Author
Generate thumbnails Author

Vocabularies, classes & properties

Operation Minimum role
List / read / stats / manifest Public
Create / update / delete Administrator

Metadata values

Operation Minimum role
List / read / stats Public
Create / update / delete Author (+ ownership)

Comments

Staff can leave internal comments on objects (Items, Item Sets, Media).

Operation Minimum role
List / read Researcher
Create Researcher
Delete Comment author, or Supervisor

Object flags

Two boolean flags can be set on any object (Item, Item Set, Media):

Flag Effect Minimum role to set
Locked Freezes the object: nobody below Supervisor can edit or delete it. Supervisor
NSFW Marks the object as sensitive. Viewers see it blurred unless they have opted in via their settings. Editor

Triage

Operation Minimum role
List / read / create Researcher
Update / delete Author
Operation Minimum role
List / read Public
Create / update / delete Editor

Extracted metadata

Operation Minimum role
List / read / stats Public
Create / update / delete Author

Activity log

Each user sees their own activity-log entries. In addition, every object exposes an audit trail: the changes made to that object by any user, including field-level before/after values. Both are read-only.

Operation Minimum role
List / read / stats Researcher
Object audit trail Researcher

System logs

Operation Minimum role
List / read / stats Administrator

User administration

Operation Minimum role
List all Researcher
Read own profile Researcher
List / read / stats Supervisor

Any signed-in user can read their own profile. Reading another user's profile needs Supervisor. List all is open to Researcher so admin owner pickers can resolve names, while paginated list, full read, and stats stay Supervisor.

System & migration

Operation Minimum role
System info Administrator
Migration preview / import Administrator
Migration list / detail Administrator
Migrate media / migrate media batch Editor