documentation

Organizations

Every user belongs to one organization. The organization is the boundary for everything: machines, projects, jobs, and volumes are all scoped to it.

Roles

There are three roles, each a superset of the one below it.

RoleWhat you can do
UserQueue jobs, upload projects and volumes, register machines, manage your own resources
AdminEverything a User can do, plus: invite members, remove Users, edit organization settings
OwnerEverything an Admin can do, plus: promote Users to Admin, demote Admins back to User, remove Admins, create admin invites, transfer ownership to an Admin

The person who creates the organization is its Owner. There is exactly one Owner per organization.

Note

Only the Owner can promote to Admin or demote them back to User. Admins can invite and remove regular Users.

Inviting members

Admins and Owners can generate a one-time join code from the Members page. The code is 8 digits (displayed as 1234-5678), and it expires after 24 hours. Give the code to the person you want to invite; they enter it during account setup to join your org.

Owners can also generate an admin invite code. It works the same way (8 digits, 24-hour expiry, single use), but the person who redeems it joins as an Admin instead of a regular User. Admin invites can only be created one at a time.

You can bulk-generate up to 50 regular codes at once and download them as a file, which is useful when onboarding a lab or class at the same time.

Managing members

The Members page lists everyone in the organization along with their role and registered machines. From there, Admins and Owners can:

  • Promote a User to Admin (Owner only).
  • Demote an Admin back to User (Owner only).
  • Remove a member from the organization. Owners can remove anyone. Admins can remove Users but not other Admins.
  • Transfer ownership to an Admin (Owner only). The current Owner is demoted to Admin. A confirmation dialog requires typing the organization name and the target member's username to prevent accidental transfers.

Removed members lose access immediately. Their volumes transfer to the organization Owner.

Leaving an organization

Admins and Users can leave voluntarily from Settings > Leave this organization. The Owner cannot leave without first transferring ownership to an Admin. Volumes belonging to a departing member transfer to the Owner automatically.

After leaving, you land back on the account setup page and can create a new org or join a different one.

Organization settings

Admins and Owners can edit the organization's profile from the Settings page (Organization tab). The profile is purely cosmetic and only visible to members of your organization. The fields are:

  • Name: how the org appears everywhere (dashboard, CLI output)
  • Website: shown on the dashboard org card with a link
  • Location: shown on the dashboard
  • Sector: shown on the dashboard
  • University name: shown on the dashboard
  • Description: shown in italics below the org name on the dashboard

The dashboard also shows a "leadership" section listing all Owners and Admins with their role badges, so members can see who to contact.