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.
Voucher, promo, referral, and hackathon codes
Every code — voucher, promo, referral, or hackathon — is redeemed in one place: the Have a code? field on the Billing page, below the top-up options. A code adds prepaid token credits to the workspace you are viewing. See Redeem a credit code. There is no code field at sign-up, and the app no longer links to a plan page. The Billing page is owner-only: open it from the profile menu (avatar, top right) → Billing. An unknown or expired code is rejected with “Could not redeem code.” and nothing is charged. If a code you were given does not work, email social@cognee.ai with the code and where you got it.Stop recurring charges
Cognee Cloud has one recurring charge: $5 / month for each additional workspace you own. Your first workspace is free, and token usage is paid from prepaid credits, so there is no plan subscription to cancel.- Stop paying for a workspace. Delete it in Settings → Workspace. Its $5 / month charge stops right after the deletion succeeds. See Workspaces.
- Stop automatic top-ups. Turn the Auto recharge switch off on the Billing page. See Auto recharge.
- Stop everything. Delete your account. This removes every workspace you own and ends their charges. See Delete your account.
Billing model
The Billing page (/billing) is where you manage prepaid token credits. Open it from the profile menu (avatar, top right) — the Billing entry there is shown to workspace owners only, and the page itself is owner-only — non-owners see “Only the owner of this workspace can manage billing and buy credits.” The Billing / Pricing button that used to sit in the sidebar footer is gone since mid-September 2026; the credit banners and insufficient-credits dialogs still link here directly.
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. An automatic recharge is charged off-session against your saved card through a Stripe invoice, and its row carries a View invoice link that opens the hosted invoice in a new tab. Checkout top-ups and redeemed credit codes also produce a Stripe invoice — a fully discounted code produces a $0 invoice recording the grant — but their rows carry no View invoice link.
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.
The Have a code? field is on the Billing page, which only workspace owners can open. If you were invited to someone else’s workspace, either ask its owner to redeem the code, or redeem it in your own Personal Workspace.
Invoices and receipts
Each credit purchase is listed under Purchase history on the Billing page, with its date, token amount, and price. How you get the invoice depends on how you paid:
If you need an invoice that is not linked on the Billing page, for example for tax or expense claims, email social@cognee.ai from your account email with the purchase date and amount. Purchase history only shows purchases made on the workspace you are currently viewing, so switch workspaces if a purchase seems to be missing.
Refunds
If there is an issue with a charge, email social@cognee.ai from your account email with the purchase date and amount.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.
The Monthly recharge limit is your spending cap: you set it yourself, and auto recharge never charges more than that in a month.
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.