Skip to main content
The API Keys page lets you create and manage keys used to authenticate with the Cloud SDK, the REST API, and agent connections.

​
Create a key

1

Open the create modal

Click Create new key. A modal opens with a name input (placeholder e.g. Production, CI/CD, Local Dev…).
2

Name and create the key

Enter a name and confirm. This calls POST /api-keys with {name}.
3

Copy the key

The new key is shown in full exactly once. Copy it immediately — afterwards only a masked label is displayed.
In cloud mode, the base URL shows your tenant URL once provisioned, or a warming up… badge while provisioning.
In local (open-source) mode, you set the LLM API key that Cognee uses to build your knowledge graph directly from the Overview page: a banner and modal let you paste the key and apply it to the running backend without editing .env.

​
Connection Details

The Connection Details card surfaces the values your clients need, each copyable: It also shows an auth-header hint: X-Api-Key: <your-api-key> • X-Tenant-Id: <tenant>. Both the X-Api-Key and X-Tenant-Id headers are used by API clients and MCP.

​
Manage keys

The page lists all active keys with their creation date (GET /api-keys). To revoke a key, click the delete icon next to it (DELETE /api-keys/{id}). Revoked keys stop working immediately.

​
API reference

Two reference links are available on the page:
  • API Reference — the shared Swagger docs at api.aws.cognee.ai/docs.
  • API Tenant Reference — your tenant instance docs at https://your-tenant.aws.cognee.ai/docs.
Store API keys in environment variables or a secrets manager. Do not hardcode them in source files.

​
Usage

Pass the API key in requests: Python SDK:
REST API:
See Cloud SDK for the full setup guide.