Skip to content

Document Admin role requirement for generating Fern API keys - #6934

Merged
nerminamiller-postman merged 1 commit into
mainfrom
devin/1789156737-api-key-admin-permissions
Sep 14, 2026
Merged

nerminamiller-postman merged 1 commit into
mainfrom
devin/1789156737-api-key-admin-permissions

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

Summary

A user hit Failed to create token because you do not have the required permissions in the <org> organization from fern token and neither the CLI reference nor the Ask Fern API overview said what permission was needed.

Venus gates generateRegistryTokens (what fern token calls) and revokeToken on the org Admin role (resolve(["admin"], VenusAction.REGISTRY_GENERATE_TOKENS) in registry_service.py); the Fern APIs themselves only need a valid key. The Dashboard API keys page already said Admins-only, but the two entry points people actually reach from the error didn't.

  • snippets/fern-token.mdx (rendered in the CLI reference + everywhere fern token is documented): states the Admin requirement and the exact error non-Admins see.
  • ask-fern/api-get-started.mdx Authentication: Admins generate keys; Editors/Viewers ask an Admin; using a key needs no extra role.
  • dashboard/permissions.mdx table: "Manage API keys" now notes it covers both the Dashboard and fern token.

Not addressed here: the user's request for non-admin API key management (a product change, not docs).

Link to Devin session: https://app.devin.ai/sessions/bcdb7901fa6342979b4b558dde1f6554
Open in Devin Desktop: https://app.devin.ai/desktop/session/bcdb7901fa6342979b4b558dde1f6554?variant=devin

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@github-actions

Copy link
Copy Markdown
Contributor

@nerminamiller-postman
nerminamiller-postman merged commit c29d345 into main Sep 14, 2026
5 checks passed
@nerminamiller-postman
nerminamiller-postman deleted the devin/1789156737-api-key-admin-permissions branch September 14, 2026 14:26
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