Getting Started

Working with Organizations

»What is an organization?

An Adaptable organization is a collection of apps and team members. The team members in the organization can manage the apps in the organization via the Adaptable web interface.

Each Adaptable organization also is a billing account that has separate payment and contact information.

»What is an organization member?

An organization member is a user with an account on Adaptable that you wish to grant access to be able to manage your apps on Adaptable. They are typically a person who works with you in a team at your company and is a developer or has DevOps expertise.

important

Users of your apps do not need to be organization members.

caution

Only invite users to your organization that you trust to deploy and manage your apps.

Users in your organization have full access to all secrets and other configuration associated with your apps.

»Personal organization

Every Adaptable user has a personal organization created for them automatically. By default, apps are created in the user's personal organization.

A personal organization can only have one member, who is also the owner.

Apps in a personal organization each have their own individual subscription plans attached to them.

»Team organizations

You can also create additional organizations in order to share access to manage your apps with your team members.

important

Team features are only available on the Team subscription plan.

You can assign each team member a role within the organization that grants the appropriate permissions for that person.

Each team organization is a separate billing account, with separate payment information and billing contact information.

Each team organization requires a Team subscription plan to become active before you can invite other team members and create apps in the organization.

»Creating an organization

To create a new organization, first go to your Organizations list. You can get to this page by clicking on the profile icon in the upper right of any page, then clicking Manage Organizations.

Once on the Organizations page, click the New Organization button.

New Organization button

Then choose a name for your organization and click Create Organization.

Before you can invite team members or create apps in the organization, you'll need to subscribe the organization to the Team subscription plan. Each organization must have its own subscription.

Click the Change Plan button, select the Team Plan, and complete the payment workflow.

Your organization is now active. You can invite team members and create apps.

»Inviting team members

To invite a team member to your organization, go to the Organization page. You can get to the page for an organization by clicking on the profile icon in the upper right of any page, then clicking Manage Organizations, then choosing the organization you would like to manage.

Invites tab of Organization page

Click the Invite Members button, enter the user's email address, then click Invite. Users are initially given the developer role, but they can be given a role with more permissions after they accept the invite.

An invitation will be sent to the email address. The invited person can then click the link in the email to accept the invite.

If the invited person does not yet have an account on Adaptable, they can sign up for an Adaptable account during the process of accepting the invite.

When a user successfully accepts an invite to an organization, both the inviter and invited person get a confirmation email.

important

In order for the user to accept the invite, they must have a GitHub account and they must have the invite email address registered as one of their email addresses in GitHub.

»Re-sending an invite email

To send an invite email again, click on the send icon to the right of the user's email address on the Invites tab.

»Revoking an invite

To revoke an invite that has not yet been accepted, click on the delete icon to the right of the user's email address on the Invites tab. After an invite has been revoked, the user will no longer be able to accept the invite and join the organization. However, you can invite the same user again at a later time if you wish.

»Managing team members

You can view the list of team members that have access to your organization on the Members tab of the Organization page. Each member is listed along with the role or roles they have been granted within the organization.

Members tab of Organization page

»Change roles for a member

To change the role or roles for an organization member, click the pencil icon to the right of the member's email address. Choose the roles for the member, then click Update Roles. Role changes take effect within a few moments.

To change roles for multiple members at a time, click the checkbox to the left of the members you wish to edit, then click the pencil icon in the header directly above the list of members.

»Removing members

To remove members from your organization, click the checkbox to the left of the members you wish to edit, then click the remove person icon in the header directly above the list of members. Member changes take effect within a few moments.

»Creating and managing apps

To view and manage the apps in your organization, go to your App Dashboard by clicking the App Dashboard button in the header of any page (or in the main menu in the upper right of the page on small screens).

App Dashboard

The apps for the current organization are shown on this page. Clicking the New App button will create a new app in the current organization.

To view or create apps in a different organization, click the name of the organization in the dropdown menu at the top of the page.

»Moving apps between organizations

Apps can be moved from one organization to another as long as the user has the owner role in both organizations. The target organization must be either a personal organization or must have a valid organization subscription.

To move an app to a different organization, contact our friendly support team.

»Roles and permissions

Organizations have two roles that can be granted to an organization member: developer and owner.

»Developer

A member with the developer role has permissions to:

  • Apps: Full control to view, create, modify, and delete all apps in the organization and to view, create, modify, and delete all cloud resources (such as databases) within those apps.

  • Organization: View organization information.

  • Members: View all organization members.

  • Subscriptions: View organization subscriptions.

»Owner

A member with the owner role has all the permissions of the developer role plus:

  • Organization: Full control to view, modify, and delete the organization.

  • Members: Full control to view, create, modify and delete organization members and member invites.

  • Subscriptions: Full control to view, create, modify and delete organization subscriptions.

  • Billing information: Full control to view, create, modify, and delete organization billing information including payment methods, billing address, and contact information.

»Billing

To access and update payment information, billing address, and to view and pay invoices for an organization, go to your Billing page and then choose an organization.

The Billing page can also be accessed by clicking on the profile icon in the upper right of any page, then choosing Billing.

note

Only members with role owner can access billing information for the organization.

note

To update the billing email address for an organization, contact our friendly support team.

»Canceling an organization subscription

To cancel the subscription for an organization at the end of the current billing period, go to your Organizations page and choose an organization. Click the Plan tab, then the Change Plan button. Finally, click the Cancel Plan button.

The features of the Teams plan will continue to be available until the end of the current billing period. Any resource usage charges for apps in the organization will continue to accrue until the end of the billing period and will be charged after the billing cycle completes.

note

To cancel your organization subscription before the end of the billing period, please contact our friendly support team.