Manage Organizations

In the organizations and projects hierarchy, an organization can contain multiple projects (previously referred to as groups). Under this structure:

• Billing happens at the organization level while preserving visibility into usage in each project.

• You can view all projects within an organization.

• You can use teams to bulk assign organization users to projects within the organization.

If you need to scale beyond the existing project limits, you can create multiple organizations.

To learn about recommendations for organizations, including organization hierarchy, see Recommendations for Atlas Orgs, Projects, and Clusters in the Atlas Architecture Center.

Create an Organization

When you create an organization, you are added as an Organization Owner for the organization.

1. View all of your organizations.

   1. Expand the Organizations menu in the navigation bar.
   2. Click View All Organizations.
2. Click New Organization.

3. Enter the name for your organization.

   Don’t include sensitive information in your organization name.

4. Select Atlas and click Next.

   You have the option of adding a new Cloud Manager organization or a new Atlas organization. For more information on Cloud Manager see the documentation.

5. Add members.

   1. For existing Atlas users, enter their username. Usually, this is the email the person used to register.
   2. For new Atlas users, enter their email address to send an invitation.
6. Specify the access for the members.

7. (Optional) Disable the IP access list requirement for the Atlas Administration API.

   When you create a new organization with the Atlas UI, Atlas requires IP access lists for the Atlas Administration API by default. If you require an IP access list, your Atlas Administration API keys can make API (Application Programming Interface) requests only from the location-based IP or CIDR (Classless Inter-Domain Routing) addresses that you specify in the IP access list.

   To disable the IP access list requirement and allow your Atlas Administration API keys to make requests from any address on the internet, toggle Require IP Access List for the Atlas Administration API to OFF.

   To learn more, see Optional: Require an IP Access List for the Atlas Administration API.

8. Click Create Organization.

View Organizations

Atlas CLI

To list all organizations using the Atlas CLI, run the following command:

atlas organizations list [options]

To return the details for the organization you specify using the Atlas CLI, run the following command:

atlas organizations describe <ID> [options]

To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas organizations list and atlas organizations describe.

See related links:

• Install the Atlas CLI

• Connect to the Atlas CLI

Atlas UI

1. Expand the Organizations menu in the navigation bar.

2. Click View All Organizations.

Leave an Organization

To leave an organization, at least another user must exist as an Owner for the organization.

1. View all of your organizations.

   1. Expand the Organizations menu in the navigation bar.
   2. Click View All Organizations.
2. Leave organization.

   For the organization you wish to leave, click its Leave button to bring up the Leave Organization dialog box.

3. Click Leave Organization in the Leave Organization dialog box.

Rename an Organization

You must have the Organization Owner role for an organization to rename it.

1. In Atlas, go to the Organization Settings page.

   1. If it’s not already displayed, select your desired organization from the Organizations menu in the navigation bar.
   2. In the sidebar, click Organization Settings.

   The Organization Settings page displays.

2. Click next to the organization name.

3. enter the new name for the organization.

4. click Save.

Delete an Organization

To delete an organization, you must have Organization Owner role for the organization.

You can’t delete an organization that has active projects. You must delete the organization’s projects before you can delete the organization.

You can’t delete an organization with outstanding payments. To learn more, see Troubleshoot Invoices and Payments.

If you have a Backup Compliance Policy enabled, you can’t delete a project if any snapshots exists. If you can’t remove all projects, you can’t delete the organization.

Atlas CLI

To delete an organization using the Atlas CLI, run the following command:

atlas organizations delete <ID> [options]

To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas organizations delete.

Atlas UI

1. In Atlas, go to the Organization Settings page.

   1. If it’s not already displayed, select your desired organization from the Organizations menu in the navigation bar.
   2. In the sidebar, click Organization Settings.

   The Organization Settings page displays.

2. In the General Settings tab, click Delete. This displays the Delete Organization dialog box.

3. Click Delete Organization to confirm.