πŸš€ News: We are launching the Kontext Labs AI-Native Data Intelligence Platform Pilot! Click here to join our pilot program.

Project roles and permissions

Effective permissions matrix for project‑scoped roles in Kontext Platform.

This page summarizes what each project role can do within a single project. Use it to understand what actions each role can perform.

Roles are created per project using these templates:

  • Project.Owner
  • Project.Admin
  • Project.Contributor
  • Project.Reader

Notes

  • Permissions are applied within each project independently.
  • ◐ β€œOwn items only” means the action is allowed for content you created.

Role vs. permission matrix

Legend: βœ… allowed Β· ❌ not allowed Β· ◐ allowed for own items only

PermissionOwnerAdministratorContributorReader
Projects Readβœ…βœ…βœ…βœ…
Projects Updateβœ…βœ…βŒβŒ
Projects Deleteβœ…βŒβŒβŒ
Datasets Readβœ…βœ…βœ…βŒ
Datasets Createβœ…βœ…βœ…βŒ
Datasets Updateβœ…βœ…β—βŒ
Datasets Deleteβœ…βœ…β—βŒ
Files Readβœ…βœ…βœ…βœ…
Files Createβœ…βœ…βœ…βŒ
Files Updateβœ…βœ…βœ…βŒ
Files Deleteβœ…βœ…β—βŒ
Query Sessions Readβœ…βœ…βœ…βŒ
Events Readβœ…βœ…βŒβŒ
Jobs Readβœ…βœ…βŒβŒ
Query Sessions Createβœ…βœ…βœ…βŒ
Query Sessions Updateβœ…βœ…β—βŒ
Query Sessions Deleteβœ…βœ…β—βŒ
Query Sessions Executeβœ…βœ…β—βŒ
Chat Sessions Readβœ…βœ…βœ…βŒ
Chat Sessions Createβœ…βœ…βœ…βŒ
Chat Sessions Updateβœ…βœ…β—βŒ
Chat Sessions Deleteβœ…βœ…β—βŒ

How role permissions apply

  • Your role within a project determines what you can do in that project.
  • Some actions (marked ◐) apply only to items you created.

Add users to a project

To give someone access to a project:

  1. Open the project and go to Settings β†’ Access & Permissions.
  2. Use the members list to add a user by User ID.
  3. Choose a role (Owner, Admin, Contributor, or Reader).
  4. Save. The user will now have access according to the role.

Assign the lowest role that enables the work needed. Use Contributor for most collaborators; Reader for view-only access.

Remove users from a project

To remove someone from a project:

  1. Open the project and go to Settings β†’ Access & Permissions.
  2. In the members list, find the user by name or User ID.
  3. Click on Remove button.
  4. Confirm the removal.

Change a user’s role

To change a member’s role in a project:

  1. Open the project and go to Settings β†’ Access & Permissions.
  2. In the members list, find the user by name or User ID.
  3. Click on Edit button
  4. Update their role (for example, switch from Reader to Contributor).
  5. Save your changes.

Self-modification rules

Users can modify their own project roles under certain conditions to prevent orphaned projects (projects with no administrators):

ScenarioAllowed?Notes
System administrator modifying own roleβœ…Platform admins can always manage their own project roles
User demoting self when other Owner/Admin existsβœ…Safe because another administrator can manage the project
User changing own role but keeping Owner/Adminβœ…User remains an administrator
Sole Owner/Admin demoting self❌Would orphan the project; add another admin first
User removing self from project❌Users cannot remove themselves from a project

Tip: If you’re the only Owner or Administrator in a project and need to leave or change your role, first assign another trusted user as Owner or Administrator.