---
title: "Authentication"
description: "Configure authentication options for Weaviate Cloud clusters by adding, updating and deleting API keys."
url: https://docs.weaviate.io/cloud/manage-clusters/authentication
---

# Authentication

A new cluster ships with no API keys — create one before you connect. This applies to free and Shared Cloud clusters alike, and both can create, edit, rotate and delete keys.

[Weaviate Cloud (WCD)](https://docs.weaviate.io/go/console?utm_content=cloud) uses [RBAC (Role-Based Access Control)](https://docs.weaviate.io/weaviate/configuration/rbac) to manage authentication. Below, you can find guides on how to create, edit, rotate and delete API keys for accessing Weaviate Cloud.

[Single sign-on](https://docs.weaviate.io/cloud/platform/single-sign-on) and [MFA enforcement](https://docs.weaviate.io/cloud/platform/multi-factor-auth#mfa-enforcement) control how people sign in to the Weaviate Cloud console. They do not affect cluster API keys.

### Create an API key

If you don't have an existing API key, you'll need to create one. Follow these steps to find the API keys section and create a new key if necessary:

[Embedded content](https://app.guideflow.com/embed/dkd8z43f9r)



**Steps to create a new API key**

To create an API key, follow these steps:

1. Open the [Weaviate Cloud console](https://docs.weaviate.io/go/console?utm_content=cloud) and [select your cluster](https://docs.weaviate.io/cloud/manage-clusters/status#select-a-cluster).
2. Navigate to the `API Keys` section of the cluster `Dashboard`. A new cluster shows the empty state `There are no API keys for this cluster yet`.
3. Click the `+ New key` button.
4. In the `Create API Key` form, provide a descriptive name for your key.
5. Choose the role for this API key. You can either select an existing role like `admin` or `viewer`, or [create a new role](https://docs.weaviate.io/cloud/manage-clusters/authorization) with specific permissions.
6. Click the `Create key` button.
7. **Important:** This is the only time your API key will be displayed. Make sure to copy it or download it and store it in a secure location immediately after creation. You will not be able to retrieve the full key again.

### Rotate an API key

Rotating an API key allows you to generate a new key while invalidating the old one, enhancing security.

[Embedded content](https://app.guideflow.com/embed/zkloxd4iok)



**Steps to rotate an API key**

To rotate an API key, follow these steps:

1. Open the [Weaviate Cloud console](https://docs.weaviate.io/go/console?utm_content=cloud).
2. [Select your cluster](https://docs.weaviate.io/cloud/manage-clusters/status#select-a-cluster) and navigate to the `API Keys` section.
3. Locate the API key you want to rotate and click the `Rotate` button next to it.
4. A confirmation dialog will appear, explaining that the old key will be invalidated. Click `Rotate key` to proceed.
5. **Important:** This is the only time your API key will be displayed. Make sure to copy it or download it and store it in a secure location immediately after creation. You will not be able to retrieve the full key again.

### Edit an API key

Editing an API key allows you to modify its assigned roles. To edit an API key for a cluster:

[Embedded content](https://app.guideflow.com/embed/er5dj20t6k)



**Steps to rotate an API key**

To edit an API key's roles and permissions, follow these steps:

1. Open the [Weaviate Cloud console](https://docs.weaviate.io/go/console?utm_content=cloud).
2. [Select your cluster](https://docs.weaviate.io/cloud/manage-clusters/status#select-a-cluster) and navigate to the `API Keys` section.
3. Locate the API key you want to edit and click the `Edit` button next to it.
4. In the `Edit API key` form, you can modify the key's description/name.
5. You can also update the roles associated with this API key. Choose from the existing roles or [assign different roles](https://docs.weaviate.io/cloud/manage-clusters/authorization).
6. Click the `Save` button to apply your changes.

### Delete an API key

To delete an API key, follow these steps:

[Embedded content](https://app.guideflow.com/embed/1pzvzx6bvr)



**Steps to delete an API key**

To delete an API key, follow these steps:

1. Open the [Weaviate Cloud console](https://docs.weaviate.io/go/console?utm_content=cloud).
2. [Select your cluster](https://docs.weaviate.io/cloud/manage-clusters/status#select-a-cluster) and navigate to the `API Keys` section.
3. Locate the API key you want to delete and click the `Trash can` button next to it.
4. A confirmation dialog will appear. Enter the necessary text (usually the API key name or a confirmation phrase) to confirm the deletion.
5. Click on the `Delete key` button.

## Further resources

- [Manage authorization in WCD](https://docs.weaviate.io/cloud/manage-clusters/authorization)
- [RBAC documentation](https://docs.weaviate.io/weaviate/configuration/rbac)

## Support

If you use **Weaviate Cloud** (Database cluster(s) or Weaviate product in the cloud) or have a self-hosted support package, open a ticket in the [Support Portal](https://support.weaviate.io) or email [Weaviate support](mailto:support@weaviate.io) directly. To add a [support plan](https://weaviate.io/support-plans), contact [Weaviate sales](https://weaviate.io/pricing#contact-sales).

Use the **Support Portal** for direct help from the Weaviate team: open and track tickets, and we'll respond in line with your support plan. The **Community Forum** is open to everyone, and a great place to ask questions, get help with your cluster, and connect with other developers. For all the ways to get help, see the [Support overview](https://docs.weaviate.io/support).

[Weaviate Support Portal](https://support.weaviate.io): Direct help from the Weaviate team for Weaviate Cloud. Open and track tickets in the Support Portal.

[Weaviate Community Forum](https://forum.weaviate.io/c/support): Ask questions, share ideas, and connect with other developers on our Community forum.
