---
description: >-
  Create and manage Verda API credentials: Cloud API credentials (Client ID
  and Client Secret) and Inference API Keys, and how to authenticate requests
  with each.
revision_date: 02.11.2026
---

# API Credentials

Verda uses two types of API credentials: **Cloud API credentials** for the general Verda API, and **Inference API Keys** for hosted model endpoints.

***

## Cloud API credentials

Cloud API credentials authenticate requests to the Verda API. The same Client ID and Client Secret pair works across the [CLI](https://docs.verda.com/developer-tools/verda-cli/), [Terraform](https://docs.verda.com/developer-tools/infrastructure-as-code/terraform/authentication/) and OpenTofu providers, and third-party integrations such as dstack and SkyPilot.

<!-- --8<-- [start:njoin-api-credential] -->
### Create Cloud API credentials

1. Log in to the [Verda Console](https://console.verda.com/).
2. Open the **Credentials** page from the sidebar.
3. Under **Cloud API credentials**, click **+ Create**.
4. Copy the **Client ID** and **Client Secret** - the secret is shown only once.

!!! warning
    Store the Client Secret somewhere safe. The Console does not display it again after creation - if you lose it, you'll need to create a new credential pair.
<!-- --8<-- [end:njoin-api-credential] -->

***

## Inference API Keys

Inference API Keys authenticate requests to [Verda Inference](https://docs.verda.com/inference/) at `https://inference.verda.com`. A key is created in a project and can call the models enabled for that project.

### Create Inference API Keys

1. Log in to the [Verda Console](https://console.verda.com/).
2. Open the **Credentials** page from the sidebar.
3. Under **Inference API Keys**, click **+ Create**.
4. Enter a **Key name** and click **Create API Key**.
5. Copy your key. It's shown only once.

You can also create a key from a model's page under **Inference > Models**. When you enable a model, the Console creates a key for you if you don't have one on the page yet.

Include the key in the `Authorization` header of each request:

```
Authorization: Bearer <your_api_key>
```

!!! warning
    Keep your Inference API Key secure and never expose it in client-side code. If you think a key has leaked, create a new one, switch your apps to it, and delete the old one.

### Delete Inference API Keys

On the **Credentials** page, delete the key under **Inference API Keys**. Requests with that key fail with `401` from then on.

To replace a key without downtime, create the new key first, switch your apps to it, then delete the old one.

***

## Credential lifecycle

<!-- --8<-- [start:pros-credential-lifecycle] -->

Both Cloud API credentials and Inference API Keys are tied to the team member who created them, not to a project. If a team member is removed from a project or leaves it, all credentials and keys they created are deleted for security purposes.
<!-- --8<-- [end:pros-credential-lifecycle] -->
See [Team Projects](https://docs.verda.com/account/account-and-access/team-project/#remove-a-team-member).
