liblab accounts and organizations

To use liblab, you need a valid user account. All liblab users are part of an organization, and there are three roles that can be assigned to users:

• Super Admin can use the liblab portal to manage everything around an organization and users, including billing and subscription management.

• Admin can use the liblab portal to manage their organization and the users who are members of that organization.

• Member can use the liblab portal to manage their account and see the SDKs they have generated, as well as use the liblab CLI to generate SDKs.

Organizations

An organization is a group of users who can share SDKs and SDK documentation.

When a liblab account is first created, an organization is created for the user, and they are made the Super Admin of that organization. Additional users can then be added to the organization, and given admin or super admin privileges if desired.

An organization is based off the user's email domain:

• If a user has a company email, the organization will be based off the company domain. For example, for [email protected] the organization will be called exciting.soda. Once the organization has been created, anyone else signing up with the same domain will automatically join that organization.
• If a user has a generic email, such as a gmail address, then the organization will be based off the email address. For example, for [email protected] the organization will be called exciting.boba. Once an organization has been created, additional users will need to be invited.

New users can be invited to join an organization. See the Organization and user administration documentation for details.

Members of the same organization can view and download all the SDKs and docs that have been generated by all members of that organization.

User roles

Users can have the following roles:

• Member
• Admin
• Super Admin

Member

Members can do the following from the portal:

• View and edit their details, including changing their password
• View a list of all members of the organization and their roles
• Invite new members by email
• Download API specs, SDKs and SDK docs
• View and approve SDK docs

They can also do the following from the liblab CLI:

• Log in, log out and change their password
• Generate long-lived tokens
• Generate SDKs and Docs
• Raise PRs

Admin

Admins can perform the same tasks as members, but they can also do the following from the portal:

• Change the role of any user (such as make a user an admin)
• Delete users
• Update details about the organization

Super Admin

Super Admins can perform the same tasks as members and admins, but they can also do the following from the portal:

• Manage billing and other subscription details