Skip to content

Document scoped API keys - #694

Draft
sjmiller609 wants to merge 3 commits into
mainfrom
hypeship/scoped-api-keys
Draft

sjmiller609 wants to merge 3 commits into
mainfrom
hypeship/scoped-api-keys

Conversation

@sjmiller609

@sjmiller609 sjmiller609 commented Oct 9, 2026 •

Copy link
Copy Markdown
Contributor

Documents scoped API keys on the API Keys page: creating a key with a policy of allow statements, and setting an exact expires_at.

Changes

  • API Keys (info/api-keys.mdx): new Scope a key to specific resources section. It explains statements, actions, and resources briefly, then gives TypeScript and Python examples and the expiry, revocation, and rotation rules. The list, rotate, and troubleshooting sections now cover policy.
  • API Key Permissions (info/api-key-permissions.mdx, new): reference page with resource formats, every action by resource kind, operations that need more than one action, and what scoped keys can't do. Added to the Manage navigation after API Keys.

Before merging

Merge once scoped key issuance ships in the API and the SDKs expose policy and expires_at on apiKeys.create. The examples use those SDK fields. Go examples are left out until the generated Go types exist.

Checked locally with mintlify dev: the page renders and the new anchors resolve.

@mintlify

mintlify Bot commented Oct 9, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
Kernel 🟢 Ready View Preview Oct 9, 2026, 7:56 PM

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

This branch was successfully deployed

1 active deployment
staging — b4552022 Deployed Oct 9, 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.

1 participant