Organizations

After having signed up to Modal, you’ve automatically received a Personal Account that you can use to run and deploy personal apps. To deploy collaborate with others, however, you can create or join an Organization.

Create an Organization

Modal Organizations are always associated with a Github organization. On the settings page, every Github organization to which you’ve granted Modal access will be listed. If you don’t see the Github organization you’re looking for, click “Refresh Github Organizations”.

Within the displayed list of organizations, you can click a list item’s “create” button to create a new Modal Organization.

Inviting new Organization members

To invite a new Organization member, first switch your dashboard environment to an Organization. Navigate to the settings page and under the “Invite Member” section enter the email address of the person you would like to invite. Click “invite” to send the invite. Invited members must be a member of the active Organization’s associated Github organization.

The invited person will receive an email with a link to join your Organization. The email link will also allow them to sign up to Modal and create a Personal Account if they do not have one already.

Create a token for an Organization

To interact with an Organization’s resources programmatically, you need to add an API token for that Organization. Existing API tokens are displayed on the settings page and new API tokens can be added for a particular Organization.

After adding a token for an Organization to your Modal config file you can activate that Organization’s environment using the CLI (see below).

For more information on API token management see the documentation about configuration.

Switching active Organization

When on the dashboard or using the CLI, the active environment determines which Personal or Organization account is associated with your actions.

Dashboard

You can switch between Organizations and your Personal Account by using the environment selector at the top of the dashboard.

CLI

To switch the Organization associated with CLI commands, use modal env activate.

Leaving an Organization

To leave an Organization, navigate to the settings page and click “leave” on a listed Organization.