Organizations are the root entity that wrap everything belonging to an account including Users, Groups, and Repositories.

Role-based access control

Access control in Dist is role-based. Users are assigned roles from which they inherit permissions.

There are three organization roles (which are distinct from repository roles):

  • Administrator
  • Developer
  • Billing1

Users are assigned the Developer role by default.

Organization roles & permissions

Permission Administrator Developer Billing1
Invite new users and manage invitations
View organization users
Create repositories
Create groups
Add and remove group maintainers
Add and remove group members
Delete groups
Grant and revoke organization roles
Grant and revoke repository roles
Edit organization details
Manage billing


Groups are a collection of users, and are used for access control within repositories.

Groups have maintainers who have the ability to:

  • add and remove group maintainers;
  • add and remove group members; and
  • delete the group.

  1. The billing role is used exclusively for billing related functions and allows the user to change plans (including cancellation) and update payment details. Email notices related to billing are also sent to all users with the billing role.