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, on any plan. Pricing has two parts:- Token usage — $1.00 per 1M tokens processed.
- Workspaces — your first workspace is free; each additional workspace is $5 / month.
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 below.Plans
The plan chooser lives at/setup (and /plan redirects there). It is headed Choose your plan — Subscribe to start building with Cognee. Cancel anytime. — or Manage your plan once you are on one, with a line naming your current plan. The token rate is the same on every plan; the plans differ in how many workspaces and how much support you get.
The cards are not headed by these plan names — each is identified on screen by its description, price, and badge, in the left-to-right order above. The names surface elsewhere: the second and third cards head their feature lists All Hobby features, plus: and All Growth features, plus:, and the line above the cards names the plan you are on.
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.”
1
Buy prepaid token credits
Purchase credits through a Stripe Checkout session. Use the quick-pick amounts (25, 100) or enter a custom amount (minimum $0.50). The estimated number of tokens the amount buys is shown before you check out.
2
Track your balance
An Available credits card shows your Remaining balance (of $X purchased) and a spend meter. A By workspace breakdown appears only once you own more than one workspace. A status line under the meter reports whether auto recharge is on, off, or failing.
3
Turn on auto recharge
Let Cognee top the workspace up automatically with your saved card when the balance runs low — see Auto recharge below.
4
Redeem a credit code
Click the Have a code? link below the top-up options to reveal the code field and add prepaid credits to the workspace — see Redeem a credit code below.
5
Review purchases
Your purchase history lists every credit purchase made on the workspace, including automatic recharges. Rows backed by a Stripe invoice carry a View invoice link that opens the hosted invoice in a new tab.
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:1
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.”
2
Enter the code
Click Have a code? to reveal the field, then type your code into it (placeholder Enter code). The input is automatically uppercased as you type. Press Enter or click Redeem to continue.
3
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.
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.
Auto recharge
Auto recharge keeps a workspace topped up automatically: when the balance drops to a threshold you choose, Cognee charges your saved card for a fixed amount so work in flight is not interrupted by a402. It is configured in the Auto recharge panel on the Billing page and is off until you turn it on.
1
Set your amounts
Fill in the fields above. If the recharge amount is under *5.00 and the monthly limit must be at least the recharge amount.” and refuses to save.
2
Turn the switch on
The Auto recharge switch takes effect immediately — you do not have to press Save first. Turning it on records your authorization for off-session charges: “By turning on auto recharge, you authorize Cognee to automatically charge your saved card
{amount} whenever your balance drops to {threshold}, up to {monthly limit} per month. You can turn this off at any time.” You can turn it off again whenever you want.3
Save edits separately
Save works independently of the switch, so you can adjust thresholds while auto recharge is off — or edit them later without re-triggering a charge. Save is only enabled while the form differs from what is stored, and a green Saved confirms the write.
Where its state shows up
- Balance card — a status line next to the spend meter reads Auto recharge: on · Y this month, Auto recharge: off, or Auto recharge: charge failed — see above.
- Failed-charge banner — if the last automatic charge failed, a red banner appears at the top of the Billing page with the reason: “Your last automatic recharge failed:
{reason}Buy credits below to update your card — auto recharge resumes after the next successful charge.” - Announcement — the first time it is available to you, a Never run out of credits again dialog introduces the feature with a Set up auto recharge button that takes you to Billing. Maybe later (or the ✕) dismisses it for good.
Auto recharge needs a saved card and a backend that supports it. On an environment that predates the feature, saving returns “Auto recharge isn’t available on this environment yet.”
When credits run out
Every operation that spends credits — uploading files (remember), graph processing (cognify / improve), and search or recall — is checked against your workspace balance before it runs. When the balance is too low, the request is rejected with HTTP 402 and the UI tells you which operation failed, instead of the request failing silently.
Insufficient-credits dialog
A Not enough credits to run dialog (for example, “Not enough credits to run upload”) appears wherever you are in the app — the check is wired into the shared workspace API client, so uploads, processing, search, and recall all surface it. It shows your Current balance and offers Dismiss or Go to billing. Its explanation depends on the workspace’s auto recharge state:
Because the dialog already explains the failure, pages no longer add their own error text for it: on the Search page the pending answer bubble is removed rather than replaced with a duplicate inline error.
Persistent notice
If you never saw the dialog — the tab was closed or reloaded before the response arrived — a red bar appears under the top bar on your next visit: Your last failed — your workspace balance is too low. with a Top up credits → link and a dismiss button.- The notice is recorded against the workspace that actually failed, so switching workspaces while a request is in flight still attributes it correctly.
- It is dropped automatically after 24 hours, and dismissing the live dialog also clears it.
Pre-flight warning on upload
Before an upload is sent, Cognee estimates its cost from the selected files and compares it with the workspace balance. If the estimate reaches or exceeds your balance, a This upload might use more credits than you have dialog shows Could cost (an “Up to ~$X.XX” ceiling) next to your Current balance, with Cancel and Top up first. There is no upload anyway path — the dialog reads “Top up to continue with this upload.” and both exits abandon the upload, so top up (or turn on auto recharge) and try again. The figure is deliberately a ceiling rather than a prediction, and the real cost is usually lower. For PDF and DOCX files the text is extracted and tokenized in the browser first, so the upload button relabels itself Estimating cost… and a progress line reads Estimating cost… while a large batch is analyzed. When a selection contains a format with no cost model, no warning is shown.Low-balance banner
While the balance is above zero but under 0.42. Agent requests may fail. At zero or below, the wording hardens to Agent requests will fail. Owners get a Top up credits → link; everyone else sees Ask the workspace owner to top up. The banner can be dismissed.The threshold was $1 before the September 2026 release, and a separate banner used to appear at ≥90% of credits spent. That percentage banner is gone — a percentage of a prepaid balance said less about whether the next request would fail than the balance itself does.
Failures during processing
A run that starts successfully and exhausts the balance part-way through never produces a client-visible 402. Instead the dataset reports it as Failed — insufficient credits in its status dot, status pill, and a dedicated banner — see Datasets. Your uploaded files are kept; top up before retrying, since a retry on an empty balance fails the same way. After you top up, retrying the build starts a new run that skips documents already processed before the failure — you don’t pay again for the work that completed. Only the unprocessed remainder (including the document that was mid-processing when the balance ran out) is run and charged. This dedicated treatment exists for dataset builds only. An automatic improve run that runs out of credits mid-run is reported on the Sessions page as a regular failed Improve entry with its failure reason shown on the entry — there is no credit-specific label there.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 deletes it and its data immediately — the confirmation reads This will permanently delete the workspace and all its data. This cannot be undone. There is no scheduled removal and nothing to cancel. Its paid seat is released from your subscription right after the deletion succeeds.
Creating a workspace
Create new workspace in the workspace picker opens a Create a new workspace dialog — Name your workspace. You can switch between workspaces from the top bar. It states which case you are in before you commit, and the button matches it:
A workspace the dialog called free is never sent to Stripe, and workspaces you were only invited to are not counted against your first free one. Cancel genuinely cancels — it closes the dialog and creates nothing — and abandoning Stripe checkout returns you to a usable app rather than a state that needs a reload to recover.
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.Delete your account
Account deletion is self-service, from Settings → Danger zone. The Delete account action there “Permanently deletes your account: every workspace you own, all their data, your subscription, and your login.”1
Open the danger zone
Go to Settings (
/settings) and scroll to the Danger zone card — “Irreversible account actions”. Click Delete account.2
Confirm with your email address
Type your own email address into the confirmation field. Permanently delete my account stays disabled until it matches (case-insensitively); Cancel backs out without deleting anything.
3
You are signed out
Cognee deletes the account server-side (
DELETE /users/me) — its workspaces, Stripe customer, and login — then routes you through the normal sign-out flow so cookies, local storage, and your Auth0 session are all cleared. If the request fails, the reason is shown inline and you stay signed in.API keys
API keys are also managed through the API Keys UI.
Health
GET /health — Basic availability probe for the Cognee Cloud service.
Returns an empty 200 OK response when the service is running.