Skip to content

docs: stop advertising project-scoped API keys - #48

Merged
jope-bm merged 3 commits into
mainfrom
docs-remove-scoped-api-keys
Sep 28, 2026
Merged

jope-bm merged 3 commits into
mainfrom
docs-remove-scoped-api-keys

Conversation

@jope-bm

@jope-bm jope-bm commented Sep 28, 2026 •

Copy link
Copy Markdown
Contributor

Why

The API Keys vs OAuth table on the API Keys page described key access as "Full workspace access (project-scoped keys available via API)". Project-scoped keys are experimental and unreleased. A Team customer read that line and asked how to create them so each of their agents could get its own key. There's no supported way to do that today.

What changed

content/03.cloud/08.api-keys.md:

  • API Keys vs OAuth table: the Access row now reads "Full access to the key's workspace". This was the only mention of project-scoped keys on the docs site.
  • Creating an API Key: added "Only owners and admins can create keys." The page didn't mention this before. It matches the web app, which hides Create Key for other roles, and the API, which returns 403 for them. I also dropped the "(Personal or a Team)" aside from the same step.

Testing

This is a text-only change. I checked both statements against the cloud code: apps/web-v2/app/pages/settings/api-keys.vue (canManageApiKeys) and apps/cloud/src/basic_memory_cloud/api/api_keys.py (require_api_key_workspace_owner).

🤖 Generated with Claude Code

Project-scoped API keys are an unreleased, experimental feature, but the
API Keys vs OAuth table said they were "available via API", which led a
customer to try to build on them. Describe API key access as full access
to the key's workspace, and note that only owners and admins can create
keys in a Team workspace.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@jope-bm

jope-bm commented Sep 28, 2026

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

To use Codex here, create a Codex account and connect to github.

jope-bm and others added 2 commits September 28, 2026 10:49
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@jope-bm
jope-bm merged commit 3c3557a into main Sep 28, 2026
1 check passed
@jope-bm
jope-bm deleted the docs-remove-scoped-api-keys branch September 28, 2026 16:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant