Manage your Astra account

In the Astra Portal, you can manage your Astra account, including editing your profile and changing your password.

If another user invited you to their Astra organization, you must sign in or create an account with the same email address that received the invitation. For more information, see Accept the invite.

You can create an Astra account manually or use SSO to automatically provision an account through your IdP platform, Google account, or GitHub account.

Your email address is the unique identifier for your Astra account.

IdP
Google
GitHub
Username and password

You can sign in to the Astra Portal through your IdP if your Organization Administrator has enabled SSO.

The first time you access the Astra application, you must review the DataStax terms and conditions.

Upon sign in, Astra determines if an account already exists for the email address associated with your sign-in credentials. If an account exists, you are signed in to your existing account. If an account does not exist, then Astra creates a new account automatically.

The default user session timeout is approximately two hours unless your administrator specifies a different timeout in the Astra application configuration in your IdP or your IdP has a different default timeout setting.

You can use your Gmail or Google Workspace account to create an Astra account and sign in to the Astra Portal.

The default user session timeout is approximately two hours.

You can use your GitHub account to create an Astra account and sign in to the Astra Portal.

To use GitHub for Astra authentication, you must have a public email address in your GitHub profile. If you are a new user, make your email public before you create an Astra account. If you are an existing user and you selected keep my email address private in your GitHub profile, you must make your email address public, and then change your password to switch to Astra local authentication. Alternatively, you can use another SSO option with the same email address as your GitHub account. If you don’t want to make your email address public, you must use a different SSO option or username and password authentication.

The default user session timeout is approximately two hours.

If you can’t use SSO, you can create an Astra account and sign in to the Astra Portal with a username and password:

Navigate to the Astra Portal.
On the Sign In page, click Sign Up.
Follow the prompts to create your account.

The default user session timeout is approximately two hours.

To sign out, in the Astra Portal header, click your avatar, and then select Logout.

Your organization membership

Your Astra account can belong to multiple Astra organizations.

Your personal organization

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 the Astra Portal, 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 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 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 your active 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 your profile

In the Astra Portal header, click your avatar, select Account, and then edit your profile:

To change your name, click Edit, enter your desired first and last name, and then click Update Name.
To change your account’s email address, contact DataStax Support.

Change your password

SSO
Username and password

If you sign in through SSO, you must change your password in your IdP profile, GitHub account, or Google account.

If you sign in to the Astra Portal with a username and password, you can change your password through the Astra Portal.

Forgot password
Reset known password

On the Astra Portal sign-in page, click Forgot Password.
Enter the email address for your account. If an Astra account exists for the specified email address, DataStax sends a password reset email to that address.
Follow the instructions in the email and the Astra Portal to reset your password.

Astra account passwords must meet the following requirements:
- At least 8 characters, including a lowercase letter, an uppercase letter, and a number.
- Doesn’t include parts of your email address.
- Doesn’t match any of your last four passwords.
Sign in to the Astra Portal with your new password.

In the Astra Portal header, click your avatar, and then select Account.
Click Reset My Password.
If the email address is correct, click Confirm. If you need to change your email address, see Edit your profile.

DataStax sends a password reset email to your account’s email address.
Follow the instructions in the email and the Astra Portal to reset your password.

Astra account passwords must meet the following requirements:
- At least 8 characters, including a lowercase letter, an uppercase letter, and a number.
- Doesn’t include parts of your email address.
- Doesn’t match any of your last four passwords.
Sign in to the Astra Portal with your new password.

Delete your account

To delete your Astra account, you must prepare your account for deletion and then delete the account:

Clean up organization assets or transfer ownership of any organizations where you are an Organization Administrator:
- If your default organization has multiple Organization Administrators, ownership is transferred to another Organization Administrator when you delete your account.
  
  If you want to delete your default organization when you delete your account, you must remove all other Organization Administrators and all resources (databases, streaming tenants, built-in integrations, and SSO configurations) from your default organization.
  
  If you are the only Organization Administrator in your default organization, the organization is deleted when you delete your account, and you must delete all resources (databases, streaming tenants, built-in integrations, and SSO configurations) before you can delete your account.
- If you are the only Organization Administrator in a non-default organization, you can do either of the following:
  - Transfer ownership: If you want to delete your account without deleting the organization, you must transfer organization ownership to another user by granting them the Organization Administrator role.
  - Delete the organization: If you want to delete your account and the organization, you must delete the organization, and then delete your account.
- If you belong to any organizations where you are not an Organization Administrator you don’t need to take any action in those organizations.
In the Astra Portal header, click your avatar, and then select Account.
On your Profile page, click Delete My Account.

If there are any unresolved resource issues blocking account deletion, Astra prompts you to resolve those. For more information, see the preceding information about preparing to deleting your account.
Enter your email address, select a reason for deleting your account, and acknowledge the risk of deleting your account.
Click Delete Account.

Your account is automatically deleted, you are signed out of the Astra Portal, and you receive a confirmation email with information about financial records and data retention following account deletion.

It is your responsibility to clean up any external assets that you created for your databases or organizations, such as private endpoints, custom DNS, or customer keys. Deleting your Astra account does not delete external assets managed outside Astra, such as those managed in your cloud provider console.

Manage your Astra account

Your organization membership

Your personal organization

Join or leave an organization

Switch your active organizations

Get an organization ID

Edit your profile

Change your password

Delete your account

See also

Was this helpful?

Give Feedback