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

# API Keys

> Learn how to create and manage API keys for access to Blnk Cloud APIs.

API keys let you securely authenticate with Blnk Cloud APIs. They allow your applications, scripts, and automated workflows to interact with Blnk Cloud programmatically.

You can manage your API keys in [Settings > API Keys](https://cloud.blnkfinance.com/cloud/settings/api-keys).

<Warning>
  **Keep your API keys secure and rotate them regularly.** API keys provide full access to your account based on their assigned scopes. Never share API keys publicly or commit them to version control.
</Warning>

***

## How API keys work

When you make an API call, include your API key in the request headers to verify your identity and authorize the operation on your Cloud workspace.

Each API key has:

* **Name:** A user-friendly identifier to help you organize and identify keys
* **Key prefix:** A partial identifier visible in the API keys list (e.g., `blnk_fdb796a5...`)
* **Scopes:** Permissions that define what the key can access (e.g., `*` for all permissions, or specific scopes like `mcp:read, mcp:write`)
* `Role:` Always set to Member (cannot be changed)
* **Expiration:** Optional expiration date, or "Never" for keys that don't expire

***

## Create an API key

<Steps>
  <Step title="Navigate to API Keys">
    1. Go to `Settings > API Keys` in your Blnk Cloud dashboard.
    2. Click `Create API Key` button in the top-right corner of the API Keys page.
  </Step>

  <Step title="Configure your API key">
    Fill in the required information:

    1. **Name:** Enter a descriptive name for your API key (e.g., "Production API Key", "Testing", "Alerts Integration")
    2. `Scopes:` Select the permissions for this key:

    * `*` for all permissions
    * Specific scopes like `mcp:read, mcp:write` for limited access

    3. `Expires:` Choose when the key should expire:

    * Select a specific date
    * Choose "Never" for keys that don't expire
  </Step>

  <Step title="Save and copy your API key">
    After creating the key, the full API key will be displayed **only once**. Copy it immediately and store it securely.

    <Warning>
      `You cannot retrieve the full API key after creation.` If you lose the key, you must create a new one.
    </Warning>
  </Step>
</Steps>

***

## Revoke an API key

If you need to disable an API key without deleting it permanently, you can revoke it. Revoked keys cannot be used for authentication but remain visible in your API keys list for reference.

<Steps>
  <Step title="Open API key details">
    Click on the API key name in the API Keys table to view its details.
  </Step>

  <Step title="Revoke the key">
    In the API key details panel, click the `Revoke Key` button.

    <Warning>
      Revoking a key will immediately disable it. Any applications or scripts using this key will stop working until you create and configure a new key.
    </Warning>
  </Step>

  <Step title="Confirm revocation">
    Confirm that you want to revoke the key. The key's status will change to **"Revoked"** in the API Keys table.
  </Step>
</Steps>

***

## Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.

To ask questions or discuss issues, please [contact us](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).

**Need help with your product?**

Get dedicated support for architecture reviews, integration planning, ledger workflows, and production deployment.