From 2e8cb7cbd498fae55dbe615e2202b4b730d6f856 Mon Sep 17 00:00:00 2001 From: Joe P Date: Mon, 28 Sep 2026 10:45:02 -0600 Subject: [PATCH 1/3] docs: stop advertising project-scoped API keys 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) --- content/03.cloud/08.api-keys.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/03.cloud/08.api-keys.md b/content/03.cloud/08.api-keys.md index 0846e12..e4eb96f 100644 --- a/content/03.cloud/08.api-keys.md +++ b/content/03.cloud/08.api-keys.md @@ -25,7 +25,7 @@ In the [web app](https://app.basicmemory.com), go to **Settings → API Keys** ### Click Create Key -Keys are grouped by workspace. Click **Create Key** next to the workspace you want the key for (Personal or a Team), then confirm with **Create**. +Keys are grouped by workspace. Click **Create Key** next to the workspace you want the key for (Personal or a Team), then confirm with **Create**. In a Team workspace, only owners and admins can create keys. ### Name Your Key @@ -185,7 +185,7 @@ Example: `bmc_K7xR2pQmNvLwYhT9sU3fAeBcDgHiJkMnOpQrStUv` | Best for | CLI, scripts, automation | Interactive apps | | Token refresh | No (long-lived) | Yes (short-lived + refresh) | | Revocation | Per-key | Per-session | -| Access | Full workspace access (project-scoped keys available via API) | Full account access | +| Access | Full access to the key's workspace | Full account access | Use **API keys** for: - Command-line tools From 83c2287e114581ededb4243eecf2a29ba5ceac20 Mon Sep 17 00:00:00 2001 From: Joe P Date: Mon, 28 Sep 2026 10:49:34 -0600 Subject: [PATCH 2/3] docs: simplify API key creation permission note Co-Authored-By: Claude Opus 5.5 (1M context) --- content/03.cloud/08.api-keys.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/03.cloud/08.api-keys.md b/content/03.cloud/08.api-keys.md index e4eb96f..d9816f2 100644 --- a/content/03.cloud/08.api-keys.md +++ b/content/03.cloud/08.api-keys.md @@ -25,7 +25,7 @@ In the [web app](https://app.basicmemory.com), go to **Settings → API Keys** ### Click Create Key -Keys are grouped by workspace. Click **Create Key** next to the workspace you want the key for (Personal or a Team), then confirm with **Create**. In a Team workspace, only owners and admins can create keys. +Keys are grouped by workspace. Click **Create Key** next to the workspace you want the key for (Personal or a Team), then confirm with **Create**. Only owners and admins can create keys. ### Name Your Key From 76a7789354859ef9bfd52290daa2c0a342c1fd7e Mon Sep 17 00:00:00 2001 From: Joe P Date: Mon, 28 Sep 2026 10:50:05 -0600 Subject: [PATCH 3/3] docs: drop workspace type aside from API key creation step Co-Authored-By: Claude Opus 5.5 (1M context) --- content/03.cloud/08.api-keys.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/03.cloud/08.api-keys.md b/content/03.cloud/08.api-keys.md index d9816f2..ceb8d85 100644 --- a/content/03.cloud/08.api-keys.md +++ b/content/03.cloud/08.api-keys.md @@ -25,7 +25,7 @@ In the [web app](https://app.basicmemory.com), go to **Settings → API Keys** ### Click Create Key -Keys are grouped by workspace. Click **Create Key** next to the workspace you want the key for (Personal or a Team), then confirm with **Create**. Only owners and admins can create keys. +Keys are grouped by workspace. Click **Create Key** next to the workspace you want the key for, then confirm with **Create**. Only owners and admins can create keys. ### Name Your Key