Manage Astra organizations

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

This page describes how to administer organizations, including creating and editing organizations.

For information about organizations associated with your personal user account, see Manage your Astra account.

Create an organization

Organizations are either standalone or part of an enterprise:

Standalone organizations: Organizations on the Free plan have no relationship to each other, and they are managed independently.
Enterprise organizations: On the Marketplace or Enterprise subscription plan, you can use enterprise organization management to centrally manage multiple related organizations under one enterprise. Enterprise organizations still have their own administrators, users, and resources; there are limits on administrative actions from the enterprise level, as explained in What is enterprise organization management.

All organizations on a Marketplace or Enterprise subscription plan belong to an enterprise, even if the enterprise has only one organization.

When you create additional organizations, you can choose to link them to the existing enterprise or not. If the organization isn’t linked to an enterprise, then it is created as a standalone organization on the Free plan.

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

IBM SaaS-managed enterprise organizations (Marketplace or Enterprise plans)
Legacy enterprise organizations
Standalone organizations (Free plan)

If your Astra enterprise is managed by an IBM SaaS account, you must deploy an instance in your IBM SaaS account to create a new organization in your Astra enterprise.

When the instance reaches Running state, the tenant owner receives an Astra organization invitation email. The tenant owner must accept the invitation to activate their administrator privileges in that organization. They must sign in to the Astra Portal with the email address that received the invitation. The invitation must be accepted even if every instance has the same owner.

If your Astra enterprise isn’t managed by an IBM SaaS account, a user with the Manage Enterprise Organization permission can create new organizations directly in an enterprise, and they can transfer qualifying existing standalone organizations into an enterprise.

Astra Portal
DevOps API

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the active organization or enterprise, and then select your enterprise.
On your enterprise’s Overview page, click Create organization.
Enter a name for the organization and an optional description.

When you create an organization in the Astra Portal, you are the initial Organization Administrator. The Organization email defaults to your Astra account email address. After you create the organization, you can invite another Organization Administrator, and then change the organization email.
If you want to create a standalone organization that doesn’t belong to any enterprise, disable Create in existing enterprise.

Organizations on a Marketplace subscription plan, such as the IBM watsonx.data PayGo plan, cannot be added to an enterprise after they are created. Only disable this option if you’re certain that this organization shouldn’t be attached to an enterprise.
If Create in existing enterprise is enabled, and you are the administrator for multiple enterprises, select the enterprise where you want to create the organization.

If you are the administrator for only one enterprise, that enterprise is selected by default.

If your enterprise is managed by an IBM SaaS account, don’t use the Astra Portal or the DevOps API to create the organization. Instead, you must deploy an instance in your IBM SaaS account, which will create an organization in Astra under the relevant enterprise.
Click Create organization.

To create an organization in your enterprise, use POST v2/enterprises/organizations:

curl -sS -L -X POST "https://api.astra.datastax.com/v2/enterprises/organizations" \
--header "Authorization: Bearer ENTERPRISE_APPLICATION_TOKEN" \
--header "Content-Type: application/json" \
--data '{
  "name": "ORG_NAME",
  "email": "ORG_EMAIL",
  "adminUserID": "ORG_ADMIN_ID",
  "enterpriseID": "ENTERPRISE_ID"
}'

Replace the following:

ENTERPRISE_APPLICATION_TOKEN: Your enterprise application token.
ORG_NAME: The name for the new organization.
ORG_EMAIL: The email address to receive administrative notifications related to this organization. Usually this is the email address of the user specified in adminUserID.
ORG_ADMIN_ID: The Astra user ID of the user who will be the initial Organization Administrator. The user must have an active Astra account. To get a list of users in an organization, including their user IDs, use GET /v2/organizations/users. For this endpoint to return the organization’s users, you must pass an organization application token, not an enterprise application token.
ENTERPRISE_ID: Your enterprise ID. If you are the administrator for multiple enterprises, make sure to use the correct ID.

A successful request returns an object containing organization details, including the new organization’s ID. DataStax uses the organizationGroupId to track organization usage for your enterprise.

No specific permissions are required to create standalone organizations. If you have an Astra account, you can create a standalone organization at any time.

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the active 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.

Standalone organizations always start on the Free plan. If you want to upgrade this organization, see Astra DB Serverless billing and usage.

Invite users

After you create an organization, you can invite users to join the organization.

For information about inviting users, removing users, and editing user roles, see Manage users and Manage roles and permissions.

Switch organizations

If you have multiple organizations, you must switch organizations to manage resources in another organization:

In the Astra Portal header, click the active 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 active 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 organizations.

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 active organization, and then select the organization for which you need an ID.

If the organization belongs to an enterprise, select the enterprise, and then select the organization in the Organizations list.
On the organization’s General page, find the Organization ID, and then click Copy.

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

To manage an organization’s settings, you must be an Organization Administrator for that organization.

Change the name or description of an organization

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

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the active organization, and then select the organization you want to edit.

If the organization belongs to an enterprise, select the enterprise, and then select the organization in the Organizations list.
On the organization’s General page, click Edit, enter the new name or description, and then click Update Organization.

Change the email address for an organization

To change an organization’s primary email address, do the following:

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the active organization, and then select the organization you want to edit.

If the organization belongs to an enterprise, select the enterprise, and then select the organization in the Organizations list.
On the organization’s General page, 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.

Configure other organization settings

Users: See Manage users.
Roles: See Manage roles and permissions.
Tokens: See Manage application tokens.
Integrations: These settings manage built-in integrations, such as vectorize embedding providers.
Billing: View and manage an organization’s subscription plan and usage.
Provisioned capacity: View and manage provisioned capacity unit (PCU) groups.
Security: Manage organization security configurations, such as SSO providers, customer-managed encryption keys, and audit logs.

Delete an organization

Deleting an organization is permanent and irreversible.

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

You cannot delete your default (personal) organization unless you delete your account.

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

Prepare to delete an organization

Clean up organization resources to prepare for deletion:

Required: Delete or remove all databases, streaming tenants, built-in integrations, SSO configurations, and PCU groups from the organization. For more information, see the following:
- Terminate Astra DB Serverless databases
- Delete streaming tenants
- Integrations overview
- Delete an SSO configuration
- Delete or discontinue PCU groups for Astra DB Serverless databases
  
  You can only delete flexible capacity PCU groups. If an organization has committed capacity PCU groups, you must wait until the end of the commitment term to delete the organization, or you can contact IBM Support to discuss other options.
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.

Delete an organization as an Organization Administrator

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the active organization, and then select the organization you want to delete.

If the organization belongs to an enterprise, select the enterprise, and then select the organization in the Organizations list.
On the organization’s General page, click Delete organization.
Enter the organization’s name, and then click Delete organization to permanently delete the organization.

If you cannot delete the organization due to unresolved assets, see Prepare to delete an organization.
If the organization belongs to an IBM SaaS-managed enterprise, delete the IBM SaaS instance that was associated with the organization.

Delete an organization as an Enterprise Administrator

To delete an organization from the enterprise level, you must be an Enterprise Administrator and the organization’s Organization Administrator.

In the Astra Portal header, click Settings.
In the Settings navigation menu, click the name of the active organization or enterprise, and then select your enterprise.
On your enterprise’s Overview page, find the organization you want to delete, click More, and then select Delete.
Enter the organization’s name, and then click Delete organization to permanently delete the organization.

If you cannot delete the organization due to unresolved assets, see Prepare to delete an organization.
If the organization belongs to an IBM SaaS-managed enterprise, delete the IBM SaaS instance that was associated with the organization.