vercel tokens

The vercel tokens command manages your personal authentication tokens. Tokens authenticate Vercel CLI commands and Vercel REST API requests on your behalf. They are scoped to your user account, and optionally to a single project. Use this command to list existing tokens, create new ones for scripts and CI environments, and revoke tokens you no longer need.

Treat tokens as secrets. The CLI shows the plaintext value of a newly created token only once. Store it in a secret manager or environment variable; never commit it to source control.

Usage

terminal

vercel tokens [subcommand]

Using the vercel tokens command to manage personal authentication tokens. When called without a subcommand, vercel tokens runs list.

Commands

list (ls)

Lists your personal authentication tokens. This is the default subcommand, so vercel tokens and vercel tokens list are equivalent.

terminal

vercel tokens
vercel tokens list
vercel tokens ls --format json

List your tokens. Use --format json for machine-readable output.

Options

Option	Type	Description
`-F, --format <FORMAT>`	String	Output format (`json`)
`--limit <NUMBER>`	Number	Maximum number of tokens to return (default 20, range 1-100)

create

add is a supported alias.

Creates a new personal authentication token with the given name. The plaintext token is printed to stdout; capture it before it scrolls away.

terminal

vercel tokens create "CI deploy"

Create a new token named CI deploy. The plaintext value is printed once.

Creating tokens with this command requires a classic personal access token with account-level scope. OAuth sessions created by vercel login cannot mint new tokens, and team-only or project-only tokens (some vcp_… values) will also be rejected. If you don't already have a classic token, create one from the Account Tokens page in the dashboard, then set VERCEL_TOKEN (or pass --token) to that value and re-run the command.

Arguments

Argument	Required	Description
`name`	Yes	Display name for the token (helps you identify it later)

Options

Option	Type	Description
`-F, --format <FORMAT>`	String	Output format (`json`)
`--project <PROJECT_ID>`	String	Optional project ID to scope the token to a single project. The CLI forwards this value directly to the API; project names are not resolved.

remove (rm, delete)

Removes a personal authentication token by ID. Use vercel tokens list first to find the token ID.

terminal

vercel tokens rm tok_abc123

Revoke the token with ID tok_abc123.

Arguments

Argument	Required	Description
`id`	Yes	ID of the token to remove

Options

Option	Type	Description
`-F, --format <FORMAT>`	String	Output format (`json`)

Examples

Create a token for CI/CD

terminal

vercel tokens create "GitHub Actions deploy"

Capture the plaintext value from stdout and set it as VERCEL_TOKEN in your CI environment.

Scope a token to a single project

terminal

vercel tokens create "Preview deploy bot" --project prj_abc123

The resulting token can only act on prj_abc123. This narrows blast radius if the token leaks.

List tokens as JSON

terminal

vercel tokens ls --format json

Useful for scripts that need to inspect or reconcile tokens.

Revoke a token

terminal

vercel tokens rm tok_abc123

Remove a token by ID.

Global Options

The following global options can be passed when using the vercel tokens command:

For more information on global options and their usage, refer to the options section.

Last updated July 15, 2026

Cross-link map: vercel tokens (/docs/cli/tokens)

From the Vercel docs graph (built 2026-10-08T05:38:39.548Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Vercel CLI Global Options — Global options are commonly available to use with multiple Vercel CLI commands. Learn about Vercel CLI's global options
vercel api — Learn how to make authenticated HTTP requests to the Vercel API using the vercel api CLI command.
Access tokens — Create and scope Vercel access tokens to your full account, a team, or a single project, then use them to authenticate A
vercel list — Learn how to list out all recent deployments for the current Vercel Project using the vercel list CLI command.
vercel connect — Learn how to manage Vercel Connect connectors using the vercel connect CLI command.

This page links to (2)

Vercel CLI Global Options — Global options are commonly available to use with multiple Vercel CLI commands. Learn about Vercel CLI's global options
How can I use the Vercel CLI for custom workflows? — You can use the Vercel CLI to deploy any application, including custom git providers and restricted source code.

Pages that link here (4)

By site: vercel-kb (1) · vercel-docs (3)

From vercel-kb

How do I use a Vercel API Access Token? — Create a Vercel API access token, scope it to your account, a team, or a project, and use it to authenticate Vercel REST

From vercel-docs

Access tokens — Create and scope Vercel access tokens to your full account, a team, or a single project, then use them to authenticate A
AI Gateway Budgets and Spend Limits — Cap AI Gateway spend for your team, a project, an individual API key, or a team member with budgets, refresh periods, sp
Vercel CLI Overview — Learn how to use the Vercel command-line interface \(CLI\) to manage and configure your Vercel Projects from the command

vercel telemetry

vercel traces

Was this helpful?