feat(cli): add tokens command (public auth token API parity) by brookemosby · Pull Request #15812 · vercel/vercel

brookemosby · 2026-04-01T20:57:49Z

Summary

New vercel tokens command aligned with public APIs:
- tokens ls → GET /v6/user/tokens (optional --limit, --format json)
- tokens add <name> → POST /v3/user/tokens (optional --project for scoped tokens)
- tokens rm <id> → DELETE /v3/user/tokens/:tokenId
All requests use useCurrentTeam: false so listing works under a team scope (v6 rejects team context otherwise).
Root + subcommand telemetry; unit tests for ls/add/rm; commands map test updated.

Test plan

pnpm --dir packages/cli run vitest-run test/unit/commands/tokens/
pnpm --dir packages/cli run vitest-run test/unit/commands/index.test.ts

Made with Cursor

Add vercel tokens with ls (GET /v6/user/tokens), add (POST /v3/user/tokens), and rm (DELETE /v3/user/tokens/:id). Requests use useCurrentTeam: false so team scope does not break user token listing. Includes telemetry and tests. Made-with: Cursor

vercel · 2026-04-01T20:58:59Z

Low Risk — New CLI command feature with tests, docs, and telemetry — no auth/billing/schema changes.

packages/cli/src/commands/tokens/: new tokens command with ls, add, rm subcommands
packages/cli/src/util/telemetry/: telemetry tracking for tokens command and subcommands
packages/cli/test/unit/commands/tokens/: unit tests for all subcommands

^{Assessed at 5a951cd.}

github-actions · 2026-04-01T20:59:42Z

🧪 Unit Test Strategy

Comparing: 8f17142 → 5a951cd (view diff)

Strategy: Affected packages only

✅ Only testing packages that have been modified or depend on modified packages.

Affected packages - 1 (3%)

vercel

Unaffected packages - 39 (98%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/build-utils
@vercel/cervel
@vercel/cli-auth
@vercel/client
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/firewall
@vercel/frameworks
@vercel/fs-detectors
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/go
@vercel/h3
@vercel/hono
@vercel/hydrogen
@vercel/koa
@vercel/nestjs
@vercel/next
@vercel/node
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/remix-builder
@vercel/routing-utils
@vercel/ruby
@vercel/rust
@vercel/static-build
@vercel/static-config
examples

Results

Unit tests: Only affected packages will run unit tests
E2E tests: Running in parallel via E2E Tests workflow
Type checks: Only affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

github-actions · 2026-04-01T20:59:44Z

📦 CLI Tarball Ready

The Vercel CLI tarball for this PR is now available!

Quick Test

You can test this PR's CLI directly by running:

npx https://vercel-jmndp88i4.vercel.sh/tarballs/vercel.tgz --help

Use in vercel.json

To use this CLI version in your project builds, add to your vercel.json:

{
  "build": {
    "env": {
      "VERCEL_CLI_VERSION": "vercel@https://vercel-jmndp88i4.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

Python Runtime Wheel

A vercel-runtime wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_RUNTIME_PYTHON="vercel-runtime @ https://vercel-jmndp88i4.vercel.sh/tarballs/vercel_runtime-0.13.0.dev1775166001+5a951cd-py3-none-any.whl"

Python Workers Wheel

A vercel-workers wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_WORKERS_PYTHON="vercel-workers @ https://vercel-jmndp88i4.vercel.sh/tarballs/vercel_workers-0.1.0.dev1775166001+5a951cd-py3-none-any.whl"

packages/cli/src/commands/tokens/add.ts

packages/cli/src/commands/tokens/rm.ts

changeset-bot · 2026-04-01T22:28:23Z

🦋 Changeset detected

Latest commit: 5a951cd

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
vercel	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

- Align with other CLI errors (2 is reserved for help). - Add unit tests for excess positional arguments. - Add changeset for vercel tokens subcommands (minor). Made-with: Cursor

- tokens add: classic-token and user-scope 403s emit structured JSON with verification_uri, hints, recovery next[] (open dashboard, export placeholder, re-run); optional verification_uri on AgentErrorPayload; export shouldEmitNonInteractiveCommandError; AGENT_REASON token_user_scope_required - tokens rm: missing id uses next[] (tokens ls, tokens rm <token_id>) with buildCommandWithGlobalFlags; honor argv --non-interactive via outputAgentError - Docs: non-interactive-mode notes for tokens add/rm - Tests for add/rm agent output Made-with: Cursor

vercel

Additional Suggestion:

Missing return after writeAgentErrorPayloadAndExit in the isAPIError branch causes fall-through to the unexpected_error block when process.exit is mocked.

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## [email protected] ### Minor Changes - Add `vercel tokens` subcommands (`ls`, `add`, `rm`) for auth token API parity with the dashboard. ([#15812](#15812)) - Add `vercel project access-summary` subcommand to list member counts by role for a project. ([#15813](#15813)) - Add `vercel project members` and `vercel project access-groups` commands, and fix `vercel teams members` to fetch all pages from the paginated team members API. ([#15786](#15786)) ### Patch Changes - Add `--id` flag to `vercel build` and `vercel env pull` to fetch deployment-scoped environment variables ([#15805](#15805)) - Updated dependencies \[]: - @vercel/[email protected] ## @vercel/[email protected] ### Minor Changes - Add Mastra framework preset ([#15076](#15076)) ## @vercel/[email protected] ### Patch Changes - Updated dependencies \[[`d034d90dcf78316ddacdcce8fd51329fb7eefe82`](d034d90)]: - @vercel/[email protected] Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

brookemosby requested review from a team as code owners April 1, 2026 20:57

vercel bot deployed to Preview April 1, 2026 20:59 View deployment

vercel bot reviewed Apr 1, 2026

View reviewed changes

packages/cli/src/commands/tokens/add.ts Outdated Show resolved Hide resolved

packages/cli/src/commands/tokens/rm.ts Outdated Show resolved Hide resolved

Merge branch 'main' into brooke/cli-parity-tokens

1aedfbd

vercel bot deployed to Preview April 1, 2026 22:34 View deployment

fix(cli): return exit code 1 for tokens add/rm too-many-args

a5d6f5c

- Align with other CLI errors (2 is reserved for help). - Add unit tests for excess positional arguments. - Add changeset for vercel tokens subcommands (minor). Made-with: Cursor

vercel bot deployed to Preview April 2, 2026 16:46 View deployment

ShayCichocki approved these changes Apr 2, 2026

View reviewed changes

brookemosby added 2 commits April 2, 2026 14:26

Merge branch 'main' into brooke/cli-parity-tokens

0cd8180

vercel bot deployed to Preview April 2, 2026 21:41 View deployment

vercel bot reviewed Apr 2, 2026

View reviewed changes

brookemosby enabled auto-merge (squash) April 2, 2026 21:50

brookemosby merged commit 4b6a9b6 into main Apr 2, 2026
179 checks passed

brookemosby deleted the brooke/cli-parity-tokens branch April 2, 2026 21:58

vercel-cli-release-bot mentioned this pull request Apr 2, 2026

Version Packages #15820

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(cli): add tokens command (public auth token API parity)#15812

feat(cli): add tokens command (public auth token API parity)#15812
brookemosby merged 5 commits intomainfrom
brooke/cli-parity-tokens

brookemosby commented Apr 1, 2026

Uh oh!

vercel bot commented Apr 1, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Apr 1, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Apr 1, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

changeset-bot bot commented Apr 1, 2026 •

edited

Loading

Uh oh!

vercel bot left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

brookemosby commented Apr 1, 2026

Summary

Test plan

Uh oh!

vercel bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

github-actions bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 CLI Tarball Ready

Quick Test

Use in vercel.json

Python Runtime Wheel

Python Workers Wheel

Uh oh!

Uh oh!

Uh oh!

changeset-bot bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

vercel bot commented Apr 1, 2026 •

edited

Loading

github-actions bot commented Apr 1, 2026 •

edited

Loading

github-actions bot commented Apr 1, 2026 •

edited

Loading

changeset-bot bot commented Apr 1, 2026 •

edited

Loading