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

# Account & Billing

> Usage-based pricing, prepaid token credits, and API keys

These endpoints are available on the platform API (`api.aws.cognee.ai`) and manage account-level resources.

## Pricing

Cognee Cloud is usage-based — you start for free and pay only for what you use. There are no fixed plan tiers. Pricing has two parts:

* **Token usage** — **\$2.50 per 1M tokens** processed.
* **Workspaces** — your first workspace is free; each additional workspace is **\$5 / month**.

Your free workspace includes **unlimited users** and **unlimited API calls**, and supports the agentic integrations (Claude Code, Codex, MCP). It is created automatically when you sign up — no Stripe checkout required. You only start paying when you process tokens beyond your prepaid balance or create additional workspaces. The per-workspace charge keeps the free general workspace open to unlimited users while gating the creation of extra workspaces.

### Credit codes

If you have a credit code, you can redeem it for prepaid token credits on the **Billing** page — see [Redeem a credit code](#redeem-a-credit-code) below.

## Billing model

The **Billing** page (`/billing`) is where you manage prepaid token credits. It is owner-only — non-owners see *"Only the owner of this workspace can manage billing and buy credits."*

<Steps>
  <Step title="Buy prepaid token credits">
    Purchase credits through a Stripe Checkout session. Use the quick-pick amounts (**$10**, **$25**, **$50**, **$100**) or enter a custom amount (minimum **\$0.50**). The estimated number of tokens the amount buys is shown before you check out.
  </Step>

  <Step title="Track your balance">
    The page shows your **Remaining balance**, a spend meter, and a per-workspace breakdown of usage.
  </Step>

  <Step title="Redeem a credit code">
    Apply a credit code under **Have a code?** to add prepaid credits to the workspace — see [Redeem a credit code](#redeem-a-credit-code) below.
  </Step>

  <Step title="Review purchases">
    Your purchase history lists every credit purchase made on the workspace.
  </Step>
</Steps>

### Redeem a credit code

A credit code adds a fixed amount of prepaid token credits to a workspace. Codes are redeemed on the **Billing** page, in the **Have a code?** field below the top-up options:

<Steps>
  <Step title="Select the workspace">
    Credits are added to the workspace you are currently viewing, so switch to the right workspace first. If no workspace is selected, redemption fails with *"No workspace selected."*
  </Step>

  <Step title="Enter the code">
    Type your code into the **Have a code?** field (placeholder **Enter code**). The input is automatically uppercased as you type. Press **Enter** or click **Redeem** to continue.
  </Step>

  <Step title="Confirm in Stripe">
    Redeeming opens a Stripe page to confirm the credit. When it is done, you are returned to the Billing page with the message *"Code redeemed. Your credits are added once Stripe confirms — this can take a few seconds."* If you cancel, you see *"Redemption cancelled — no credits were added."* and nothing is charged or credited.
  </Step>
</Steps>

<Note>
  Each code can be redeemed once per user — a code you have already redeemed is blocked. An invalid or unredeemable code shows *"Could not redeem code."* Credits appear in your **Remaining balance** a few seconds after Stripe confirms.
</Note>

## Workspaces

Your first workspace is the **Personal Workspace** — it is free, cannot be deleted, and supports unlimited users.

Each additional workspace you own costs **\$5 / month**:

* Creating an extra workspace charges immediately, with proration applied (`proration_behavior: always_invoice`).
* Removing a workspace is scheduled for the end of the current billing period; you keep it until then, and a scheduled removal can be cancelled before it takes effect.

## Payment method

Your free workspace can be created without adding a payment method. A payment method is required for additional workspaces and for billable usage beyond your prepaid balance. When a customer who already has a default payment method on file is charged for a workspace, the subscription is created directly against that card; Stripe Checkout is used as a fallback when card verification (such as 3D Secure) is required.

## API keys

| Endpoint                          | Description                                                |
| --------------------------------- | ---------------------------------------------------------- |
| `GET /api/v1/api-keys`            | List all API keys for the authenticated user               |
| `POST /api/v1/api-keys`           | Generate a new API key                                     |
| `DELETE /api/v1/api-keys`         | Delete an API key                                          |
| `POST /api/v1/api-keys/check`     | Validate whether an API key is active                      |
| `GET /api/v1/api-keys/my-user-id` | Get the user ID associated with the current authentication |

API keys are also managed through the [API Keys UI](/cognee-cloud/ui/api-keys).

## Health

**`GET /health`** — Basic availability probe for the Cognee Cloud service.

Returns an empty `200 OK` response when the service is running.