> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ramalama.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating API Keys

> Learn how to create and manage API keys for RamaLama Cloud.

API keys authenticate your applications to RamaLama Cloud and provision access to a variety of hosted API gateways.
With a single API key, you can access models from multiple providers through a unified interface.

<Note>
  To use API keys, you must first add billing information on the **Profile Settings** page.
</Note>

## Create an API Key

<Steps>
  <Step title="Log in">
    Go to the [RamaLama Cloud dashboard](https://app.ramalama.com) and sign in to your account.
  </Step>

  <Step title="Navigate to API Keys">
    Click **API Keys** in the left panel.
  </Step>

  <Step title="Create the key">
    Click **Create New Key**, enter a descriptive name (e.g., "Production Server" or "Development"), and click **Create**.
  </Step>

  <Step title="Copy your key">
    Copy your API key immediately.

    <Warning>
      For security reasons, the full key is only shown once.
    </Warning>
  </Step>
</Steps>

## Best Practices

* **Use descriptive names** - Name keys by their purpose or environment
* **Create separate keys** - Use different keys for development, staging, and production
* **Rotate regularly** - Regenerate keys periodically to maintain security
* **Never commit keys** - Keep API keys out of version control

## Managing Keys

From the API Keys page you can:

* View all active keys and their creation dates
* See when each key was last used
* Revoke keys that are no longer needed

## Revoking a Key

If a key is compromised or no longer needed:

<Steps>
  <Step title="Navigate to API Keys">
    Click **API Keys** in the left panel.
  </Step>

  <Step title="Find and revoke">
    Find the key you want to revoke and click **Revoke**.
  </Step>

  <Step title="Confirm">
    Confirm the action.
  </Step>
</Steps>

Revoked keys immediately stop working. Any applications using the key will receive authentication errors.
