Repository navigation
docs(cli): document fern org token list/create/revoke - #7589
Merged
Merged
Conversation
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Ryan-Amirthan
requested review from
jkonrath-postman and
nerminamiller-postman
as code owners
October 23, 2026 20:06
Contributor
|
I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".
|
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
| --- | ||
|
|
||
| [Admins](/learn/dashboard/configuration/permissions) can create and manage API keys from the [Fern Dashboard](https://dashboard.buildwithfern.com/fern/tokens). API keys authenticate the Fern CLI in CI/CD pipelines, for example when publishing SDKs or documentation from GitHub Actions. | ||
| [Admins](/learn/dashboard/configuration/permissions) can create and manage API keys from the [Fern Dashboard](https://dashboard.buildwithfern.com/fern/tokens). API keys authenticate the Fern CLI in CI/CD pipelines, for example when publishing SDKs or documentation from GitHub Actions. The same keys can be listed, exported to CSV, created, and revoked from the terminal with the [`fern org token`](/learn/cli-api-reference/cli-reference/general-commands#fern-org-token-list) commands. |
Contributor
There was a problem hiding this comment.
📝 [vale] <Microsoft.OxfordComma> reported by reviewdog 🐶
Use the Oxford comma in ', for example when publishing SDKs or documentation from GitHub Actions.'.
Contributor
|
🌿 Preview your docs: https://fern-preview-devin-1792785949-org-token-commands.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
nerminamiller-postman
approved these changes
Oct 23, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
CLI 5.172.0 added
fern org token list,create, andrevoke(fern#18024), now documented on General commands. Each gets a table row and accordion with flags:list --json/--csv/--org,create --description/--json/--org,revoke <token-id> --json. Permissions come from live Venus (postman-eng/sdk-gen-venusapi_keys_service.py): list = any member, create and revoke = Admin. All three need afern loginuser session; CLI rejects an orgFERN_TOKEN.fern tokensnippet now says its key shows infern org token listand the dashboard, and is revocable there, since 5.172.0 mints it through the api-keys path. Dashboard API keys page and permissions table link to the new commands. Also fixes one existing Vale error (does nottodoesn't) on the same page so the pre-commit hook passes. No changelog entry: CLI changelog is generated.Jira: https://postmanlabs.atlassian.net/browse/FERNDOC-531
Link to Devin session: https://app.devin.ai/sessions/6f1ae28ccebd452da8d161d3c0a0836a
Open in Devin Desktop: https://app.devin.ai/desktop/session/6f1ae28ccebd452da8d161d3c0a0836a?variant=devin
Requested by: @Ryan-Amirthan