Manage organizations

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

Your personal organization

When you create an Astra DB 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 remove, leave, or transfer ownership of your default organization. Deleting your account also deletes your default organization.

Create an organization

In the Astra Portal header, click the current organization name, and then click Manage Organizations.
Click Add Organization.
Enter a name for the new organization.

When you create an organization, you are the initial Organization Administrator. To add administrators and other users to the new organization, invite users to the new organization.
Click Create Organization.
(Recommended) Invite users to the new organization.

Switch organizations

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 your organization ID

Astra Portal
DevOps API

You can get your organization ID from any Astra Portal URL, such as astra.datastax.com/org/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**" }

Edit organization settings

For information about 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.

Leave an organization

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.

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 all databases from the organization.
- (Optional) If you no longer need them, delete streaming tenants or Langflow instances.
- (Recommended) Clean up an resources in your cloud provider associated with customer keys, custom domains, or private endpoints that were used by the organization or any of its databases.
In the Astra Portal navigation menu, click the current organization name, and then click Manage Organizations.
Find the organization you want to delete, and then click Delete.
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.