Manage Astra DB organizations

You can create or join multiple Astra DB organizations to separate resources, billing, access, teams, customers, environments, or any other categories that are useful for you.

Your organization membership

Your Astra DB account can belong to multiple Astra DB organizations.

When you create an Astra account, an initial organization is created for you. This is your default or personal organization, and it is named after your account’s email address. When you sign in to Astra DB, your personal organization is selected by default.

DataStax doesn’t recommend using the default organization for production workloads because certain features aren’t available to the default organization, such as SSO. Instead, create additional, non-default organizations.

You can’t delete or leave your default organization. However, you can transfer organization ownership when you delete your account. If you are the only Organization Administrator in your default organization, the organization is deleted when you delete your account.

Join or leave an organization

To join an organization, you must receive an invitation from an Organization Administrator or sign in with SSO. For more information, see Manage users.

To leave an organization, you must ask an Organization Administrator to remove you from the organization.

Alternatively, if you have an application token with sufficient privileges, you can use the DevOps API to remove yourself from the organization.

For more information, see Remove a user or revoke an invitation.

Switch your active organization

If you create organizations or get invited to other organizations, you must switch organizations to work with the databases and other resources in those organizations:

In the Astra Portal header, click the current organization name.
From the list of organizations, select the organization that you want to switch to.

Get an organization ID

Astra Portal
DevOps API

You can get the current organization ID from any Astra Portal URL, such as astra.datastax.com/org/ORGANIZATION_ID/. If you belong to multiple organizations, the URL reflects your current active organization. For more information, see Switch your active organization.

You can also get an organization’s ID from the organization settings:

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the current organization, and then select the organization for which you need an ID.
In the Settings navigation menu, click General.
Locate the Organization ID, and then click Copy to copy the organization ID.

You can use GET /v2/currentOrg to get the organization ID associated with a given application token:

curl -sS -L -X GET "https://api.astra.datastax.com/v2/currentOrg" \
--header "Authorization: Bearer APPLICATION_TOKEN" \
--header "Content-Type: application/json"

A successful request returns the organization ID associated with the token:

{ "id": "**ORG_ID**" }

Create an organization

Organizations are either standalone or part of an enterprise:

Standalone organizations: On the Free and Pay As You Go subscription plans, organizations have no relationship to each other, and they are managed independently.
Enterprise organizations: On the Enterprise subscription plan, you can use enterprise organization management to centrally manage multiple related organizations under one enterprise.

Your Astra DB account can belong to both types of organizations, and you can be both an Enterprise Administrator and an Organization Administrator.

Standalone organizations
Enterprise organizations

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the current organization, and then select Create Organization.
Enter a name for the organization and an optional description.

When you create an organization, you are the initial Organization Administrator, and the Organization email defaults to your Astra account email address. After you create the organization, you can change the Organization email.
Click Create Organization.
(Recommended) Invite users to the new organization.

The Enterprise subscription plan includes centralized organization management, also known as enterprise organization management. For information about creating organizations under an enterprise, see Manage your enterprise.

Edit organization settings

To change an organization’s display name, description, or email address, do the following:

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the current organization, and then select the organization you want to edit.
In the Settings navigation menu, click General.
Edit the organization name, description, or email address:
- To change the organization’s display name and description, click Edit, enter the new name and description, and then click Update Organization.
- To change the organization’s administrative email address, click Update Email, enter the desired email address, and then click Update Email.
  
  DataStax sends a verification email to the new email address. To confirm this change, you or another Organization Administrator must have access to the new email address. Follow the link in the verification email to finalize the change.

For information about other organization settings, see the following:

Users: See Manage users.
Roles: See Manage roles and permissions.
Tokens: See Manage application tokens.
Integrations: Manage built-in integrations, such as vectorize embedding providers. See Integrations overview.
Billing: View and manage the organization’s subscription plan, payment method, invoices, and usage. See Subscriptions and billing.
Security: Manage organization security configurations, such as SSO, customer keys, audit logs, the DevOps API IP access list, and custom domains.

Delete an organization

If you are the Organization Administrator for multiple organizations, you can delete organizations you no longer need.

You can’t delete your default (personal) organization unless you delete your account.

Deleting an organization is permanent and irreversible.

To delete an organization, do the following:

Clean up organization resources to prepare for deletion:
- (Required) Delete or remove all databases, streaming tenants, built-in integrations, and SSO configurations from the organization. For more information, see the following:
- (Optional) If you no longer need them, delete Langflow instances.
- (Recommended) Clean up any resources in your cloud providers associated with customer keys, custom domains, or private endpoints that were used by the organization or any of its databases.
In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the current organization, and then select the organization you want to delete.
In the Settings navigation menu, click General.
Click Delete organization.
Enter the organization’s name, and then click Delete Organization to permanently delete the organization.

Billing and usage for deleted organizations is included in the current billing period up until the time of deletion.

Manage Astra DB organizations

Your organization membership

Your personal organization

Join or leave an organization

Switch your active organization

Get an organization ID

Create an organization

Edit organization settings

Delete an organization

See also

Was this helpful?

Give Feedback