Skip to content

CTX7-3507: Document read-only API keys and the Write access box - #3593

Merged
enesgules merged 5 commits into
masterfrom
CTX7-3507/read-only-api-keys
Nov 2, 2026
Merged

enesgules merged 5 commits into
masterfrom
CTX7-3507/read-only-api-keys

Conversation

@enesgules

@enesgules enesgules commented Oct 30, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Docs (howto/api-keys, howto/admin-mcp): every API key can read the management API and use the Admin MCP read tools. The create-key box is now Write access (it was "Management access"), and only a key with it can make changes. The invite link needs it too. The anchor is now #write-access.
  • Admin MCP: README, server card, landing page, and the hint for the new error code write_access_required (it was management_access_required).
  • New screenshot /images/dashboard/api-key-write-access.png (the dialog with Write access ticked) replaces api-key-management-access.png.

Reviewer notes

  • Deploy after upstash/context7app#1585, which returns the new error code.
  • @upstash/context7-admin-mcp is private, so there is no changeset.

Part of CTX7-3507

@vercel

vercel Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
context7-admin-mcp Ignored Ignored Nov 2, 2026 7:13am UTC

Request Review

@mintlify

mintlify Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
context7 🟢 Ready View Preview Oct 30, 2026, 1:15 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@linear-code

linear-code Bot commented Oct 30, 2026

Copy link
Copy Markdown

CTX7-3507

@context7

context7 Bot commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

Docs7 for context7.com

Result Status Action
Deployment ✅ Ready Open preview
Content review ✅ Passed. No problems found. —

Commit 62afc52 · Updated 2026-11-02 07:14 UTC · View build details

@context7
context7 Bot temporarily deployed to Docs7 Preview: CTX7-3507/read-only-api-keys October 30, 2026 09:09 Destroyed
@enesgules enesgules changed the title CTX7-3507: Document read-only API keys on the Admin MCP and management API CTX7-3507: Document read-only API keys and the Write access box Oct 30, 2026
@context7
context7 Bot temporarily deployed to Docs7 Preview: CTX7-3507/read-only-api-keys October 30, 2026 10:54 Destroyed
@context7
context7 Bot temporarily deployed to Docs7 Preview: CTX7-3507/read-only-api-keys October 30, 2026 12:02 Destroyed
@context7
context7 Bot temporarily deployed to Docs7 Preview: CTX7-3507/read-only-api-keys October 30, 2026 13:16 Destroyed
@context7
context7 Bot temporarily deployed to Docs7 Preview: CTX7-3507/read-only-api-keys November 2, 2026 07:14 Destroyed

@ramazanoacar ramazanoacar left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, the docs, the README, the server card, the landing page and the hint for write_access_required all match the app change, and replacing the screenshot keeps the dialog and the docs in step.

I left a question on upstash/context7app#1585 about turning on read access for every existing key, since member emails, visitor conversations and deployment logs become readable with keys that were created only for docs. If that PR changes the default (for example, new keys only, or keeping personal-data reads behind Write access), the wording here ("every API key can read the management API") will need to follow it. So I'm holding off on approving until that settles. The rest looks ready.

@enesgules

Copy link
Copy Markdown
Collaborator Author

upstash/context7app#1585 keeps read access for every API key, including the existing ones (reasons in my reply there: https://github.com/upstash/context7app/pull/1585). So the wording here ("every API key can read the management API") stays as it is.

@ramazanoacar ramazanoacar left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks Enes, and thanks for the explanation on the app side. Keeping read access for every key is a fair call, especially since usage and policies were already readable with any key. The wording here matches that decision. I didn't find any "Management access" or management_access_required left in the docs or the Admin MCP. Approving 👍 (to merge after the app change is deployed, as the PR says).

Suggestion (non-blocking)

  • This changes what existing keys can do, so it might be worth saying so in howto/api-keys under Write access: "This includes keys created before . A read-only key can read member emails, Ask and Docs7 conversations, and build logs, so revoke any key you no longer need." That way teams with older keys in CI or shared configs know to check them.

@enesgules
enesgules merged commit 0d063ba into master Nov 2, 2026
8 checks passed
@enesgules
enesgules deleted the CTX7-3507/read-only-api-keys branch November 2, 2026 08:29

This branch was successfully deployed

1 active (outdated) deployment
Docs7 Preview: CTX7-3507/read-only-api-keys — 62afc521 Deployed Nov 2, 2026 by context7[bot]
staging - docs — cd3bf466 Deployed Oct 30, 2026 by mintlify[bot]
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.

2 participants