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

Payment method

A payment method is required to use Cognee Cloud. The Plan page displays a warning banner when your subscription is active but no payment method is attached to your account. Clicking Add payment method in the banner opens a Stripe Checkout session where you can save a card. When a customer who already has a default payment method on file starts a paid plan, the subscription is created directly against that card.

Changing plans

The Plan page is also where you upgrade or downgrade an existing subscription.
  • Upgrades take effect immediately. Stripe creates the proration for the price difference and invoices it right away (proration_behavior: always_invoice), so the next charge you see reflects the new plan.
  • Downgrades are scheduled for the end of the current billing period — you keep your current plan until then.
While a downgrade is scheduled, the Plan page shows a yellow banner: “Your plan will change to [next plan] on [date].” The banner includes a Keep current plan button that calls the scheduled-downgrade cancellation endpoint and reverts the change so you stay on the current plan with no break in service. The cancellation banner (shown after you cancel a subscription) uses the same visual style.

Subscriptions

EndpointDescription
GET /api/v1/subscriptions/statusCheck subscription status: none, trial, cancelled, or active
POST /api/v1/subscriptions/unsubscribeCancel an active subscription
POST /api/v1/subscriptions/resubscribeReactivate a cancelled subscription

API keys

EndpointDescription
GET /api/v1/api-keysList all API keys for the authenticated user
POST /api/v1/api-keysGenerate a new API key
DELETE /api/v1/api-keysDelete an API key
POST /api/v1/api-keys/checkValidate whether an API key is active
GET /api/v1/api-keys/my-user-idGet the user ID associated with the current authentication
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.