[metadata]
color-scheme: dark light
description: Manage your personal Vercel authentication tokens from the CLI: list, create, and remove access tokens for use with the Vercel API and Vercel CLI.
googlebot: index, max-video-preview:-1, max-image-preview:large, max-snippet:-1
initiator-trace: 00-5e0370c32f6aa17862197a26bacee5ef-7361ef74c54f86d2-01
og:description: Manage your personal Vercel authentication tokens from the CLI: list, create, and remove access tokens for use with the Vercel API and Vercel CLI.
og:image:url: https://vercel.com/api/docs-og?title=vercel%20tokens&format=docs&sig=93cdb098a640ad28f966e852523626b595743d2fe7120095f07b12cd0f448f32&category=Ship%20and%20scale&subcategory=CLI
og:title: vercel tokens
og:url: https://vercel.com/docs/cli/tokens
robots: index, follow
theme-color: #0a0a0a
trace-attributes: {"next.appdir":true}
twitter:card: summary_large_image
twitter:description: Manage your personal Vercel authentication tokens from the CLI: list, create, and remove access tokens for use with the Vercel API and Vercel CLI.
twitter:image: https://vercel.com/api/docs-og?title=vercel%20tokens&format=docs&sig=93cdb098a640ad28f966e852523626b595743d2fe7120095f07b12cd0f448f32&category=Ship%20and%20scale&subcategory=CLI
twitter:title: vercel tokens
viewport: width=device-width, initial-scale=1, maximum-scale=1, viewport-fit=cover

[canonical-links]
https://vercel.com/docs/cli/tokens

[document-links]
--cwd: /docs/cli/global-options#current-working-directory
--debug: /docs/cli/global-options#debug
--global-config: /docs/cli/global-options#global-config
--help: /docs/cli/global-options#help
--local-config: /docs/cli/global-options#local-config
--no-color: /docs/cli/global-options#no-color
--non-interactive: /docs/cli/global-options#non-interactive
--scope: /docs/cli/global-options#scope
--team: /docs/cli/global-options#team
--token global option: /docs/cli/global-options#token
--token: /docs/cli/global-options#token
--version: /docs/cli/global-options#version
/home
AI Apps: /solutions/ai-apps
AI Gateway: /ai-gateway
AI Gateway: /docs/ai-gateway
AI Integrations: /docs/agent-resources/integrations-for-models
AI SDK: /ai-sdk
AI SDK: /docs/ai-sdk
APIs & SDKs: /docs/rest-api
About: /about
Academy: /academy
Acceptable Use Policy: /legal/acceptable-use-policy
Account Tokens page: /account/tokens
Account tokens: /account/tokens
Agent Resources: /docs/agent-resources
Agent Skills: https://skills.sh
All frameworks: /docs/frameworks
Articles: /i
Blog ↗: https://vercel.com/blog
Blog: /blog
Bot ID: /botid
Bot Management: /docs/bot-management
Bot Management: /security/bot-management
BotID: /docs/botid
Build Output API: /docs/build-output-api
Builds: /docs/builds
CI/CD: /products/previews
CLI: /docs/cli
Careers: /careers
Changelog ↗: https://vercel.com/changelog
Changelog: /changelog
Chat SDK New: /chat
Checks: /docs/checks
Commerce: /solutions/composable-commerce
Community ↗: https://community.vercel.com
Community: https://community.vercel.com
Compliance: /docs/security/compliance
Connect New: /connect
Container Registry beta: /docs/container-registry
Container Registry: /docs/container-registry
Content Delivery: /cdn
Cookie Policy: /legal/cookie-policy
Cron Jobs: /docs/cron-jobs
Customers: /customers
DPA: /legal/dpa
Delivery Network: /docs/cdn
Deploying from CLI: /docs/cli/deploying-from-cli
Deployment Protection: /docs/deployment-protection
Deployments: /docs/deployments
Design Engineers: /solutions/design-engineering
Docs: /docs
Domains: /docs/domains
Domains: /domains
Drop new: /docs/drop
Enterprise: /enterprise
Errors: /docs/errors
Events: /events
FastAPI: /docs/frameworks/backend/fastapi
Feature Flags: /docs/flags
Firewall: /docs/vercel-firewall
Flags SDK: /docs/flags/flags-sdk-reference
Fluid Compute: /docs/fluid-compute
Fluid Compute: /fluid
Frameworks: /docs/frameworks
Functions: /docs/functions
Fundamentals: /docs/fundamentals
Getting Started: /docs/getting-started-with-vercel
Getting started: /docs/getting-started-with-vercel
Git: /docs/git
GitHub: https://github.com/vercel
Global Options: /docs/cli/global-options
Glossary: /docs/glossary
Help: /help
Identity & Access: /docs/rbac
Incremental Migration: /docs/incremental-migration
Instagram: https://www.instagram.com/vercel/
Instant Rollback: /docs/instant-rollback
Integrations: /docs/integrations
Knowledge Base: /kb
Legal (all documents): /legal
Limits: /docs/limits
LinkedIn: https://linkedin.com/company/vercel
Log In: /login
MCP: /docs/mcp
Marketing Sites: /solutions/marketing-sites
Marketplace APIs: /docs/integrations/create-integration/marketplace-api/reference
Marketplace: /marketplace
Microfrontends: /docs/microfrontends
Monorepos: /docs/monorepos
Networking: /docs/networking
Next vercel traces: /docs/cli/traces
Next.js: /frameworks/nextjs
Nitro: /docs/frameworks/backend/nitro
Notifications: /docs/notifications
Nuxt: /docs/frameworks/full-stack/nuxt
Observability: /docs/observability
Observability: /products/observability
Open Source Program: /open-source-program
Overview: /docs/cli
Partner Finder: /partners/solution-partners
Passport New: /passport
Passport new: /docs/passport
Plans: /docs/plans
Platform Engineers: /solutions/platform-engineering
Platform Security: /security
Platforms: /solutions/multi-tenant-saas
Press: /press
Previous vercel telemetry: /docs/cli/telemetry
Pricing: /docs/pricing
Pricing: /pricing
Privacy Policy: /legal/privacy-policy
Production Checklist: /docs/production-checklist
Project Configuration: /docs/project-configuration
Project Linking: /docs/cli/project-linking
Projects: /docs/projects
Queues SDK New: /docs/queues/sdk
Queues beta: /docs/queues
REST API: /docs/rest-api
Release Notes: /docs/cli/release-notes
Rolling Releases: /docs/rolling-releases
Routing Middleware: /docs/routing-middleware
Routing: /docs/routing
Sandbox: /docs/sandbox
Sandbox: /sandbox
Security & Compliance: /docs/security
Services beta: /docs/services
Shipped on Vercel: /shipped
Sign Up: /signup
Spend Management: /docs/spend-management
Startups: /startups
Status: https://vercel-status.com
Storage: /docs/storage
Streamdown: https://streamdown.ai
Support Center: /docs/support-center
SvelteKit: /docs/frameworks/full-stack/sveltekit
Tanstack Start: /docs/frameworks/full-stack/tanstack-start
Telemetry: /docs/cli/about-telemetry
Templates: /templates
Terms of Service: /legal/terms
Toolbar: /docs/vercel-toolbar
Trust Center: https://security.vercel.com
Turborepo: /solutions/turborepo
Using Vercel CLI for custom workflows: /kb/guide/using-vercel-cli-for-custom-workflows
Vercel + AWS: /partners/aws
Vercel Agent: /agent
Vercel Agent: /docs/agent
Vercel Connect beta: /docs/connect
Vercel Drop New: /drop
Vercel MCP: /docs/mcp
Vercel Plugin New: /plugin
Vercel SDK: /docs/rest-api/sdk
Vercel Toolbar: /docs/vercel-toolbar
Vercel for Platforms: /docs/platforms
WAF: /security/web-application-firewall
Web Apps: /solutions/web-apps
Webhooks: /docs/webhooks
Workflow SDK New: /workflows
Workflow: /docs/workflows
Workflows: /docs/workflows
Workflows: /workflows
X: https://x.com/vercel
YouTube: https://youtube.com/@VercelHQ
eve New: /eve
eve New: https://eve.dev/
eve beta: /docs/eve
global options: /docs/cli/global-options
options section: /docs/cli/global-options
v0 ↗: https://v0.app
v0: https://v0.app
vercel activity: /docs/cli/activity
vercel agent: /docs/cli/agent
vercel ai-gateway: /docs/cli/ai-gateway
vercel alerts: /docs/cli/alerts
vercel alias: /docs/cli/alias
vercel api beta: /docs/cli/api
vercel bisect: /docs/cli/bisect
vercel blob: /docs/cli/blob
vercel build: /docs/cli/build
vercel buy: /docs/cli/buy
vercel cache: /docs/cli/cache
vercel certs: /docs/cli/certs
vercel connect beta: /docs/cli/connect
vercel contract: /docs/cli/contract
vercel crons beta: /docs/cli/crons
vercel curl beta: /docs/cli/curl
vercel deploy-hooks: /docs/cli/deploy-hooks
vercel deploy: /docs/cli/deploy
vercel dev: /docs/cli/dev
vercel dns: /docs/cli/dns
vercel domains: /docs/cli/domains
vercel env: /docs/cli/env
vercel firewall: /docs/cli/firewall
vercel flags: /docs/cli/flags
vercel git: /docs/cli/git
vercel global-config: /docs/cli/global-config
vercel guidance: /docs/cli/guidance
vercel help: /docs/cli/help
vercel httpstat beta: /docs/cli/httpstat
vercel init: /docs/cli/init
vercel inspect: /docs/cli/inspect
vercel install: /docs/cli/install
vercel integration: /docs/cli/integration
vercel link: /docs/cli/link
vercel list: /docs/cli/list
vercel login: /docs/cli/login
vercel logout: /docs/cli/logout
vercel logs: /docs/cli/logs
vercel mcp: /docs/cli/mcp
vercel metrics: /docs/cli/metrics
vercel microfrontends: /docs/cli/microfrontends
vercel oauth-apps: /docs/cli/oauth-apps
vercel open: /docs/cli/open
vercel project: /docs/cli/project
vercel promote: /docs/cli/promote
vercel pull: /docs/cli/pull
vercel redeploy: /docs/cli/redeploy
vercel redirects: /docs/cli/redirects
vercel remove: /docs/cli/remove
vercel rollback: /docs/cli/rollback
vercel rolling-release: /docs/cli/rolling-release
vercel routes: /docs/cli/routes
vercel sandbox: /docs/cli/sandbox
vercel skills: /docs/cli/skills
vercel switch: /docs/cli/switch
vercel target: /docs/cli/target
vercel teams: /docs/cli/teams
vercel telemetry: /docs/cli/telemetry
vercel tokens: /docs/cli/tokens
vercel traces: /docs/cli/traces
vercel upgrade: /docs/cli/upgrade
vercel usage: /docs/cli/usage
vercel vcr: /docs/cli/vcr
vercel webhooks beta: /docs/cli/webhooks
vercel whoami: /docs/cli/whoami
xmcp: /docs/frameworks/backend/xmcp

[structured-data]
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://vercel.com/docs","name":"Vercel Documentation","position":1},{"@type":"ListItem","item":"https://vercel.com","name":"Ship and scale","position":2},{"@type":"ListItem","item":"https://vercel.com/docs/cli","name":"CLI","position":3},{"@type":"ListItem","item":"https://vercel.com/docs/cli/tokens","name":"vercel tokens","position":4}]}
{"@context":"https://schema.org","@type":"TechArticle","author":{"@type":"Organization","name":"Vercel"},"dateModified":"2026-07-15T15:07:37.000Z","description":"Manage your personal Vercel authentication tokens from the CLI: list, create, and remove access tokens for use with the Vercel API and Vercel CLI.","headline":"vercel tokens","image":{"@type":"ImageObject","height":"630","url":"https://vercel.com/api/docs-og?title=vercel%20tokens&format=docs&sig=93cdb098a640ad28f966e852523626b595743d2fe7120095f07b12cd0f448f32","width":"1200"},"url":"https://vercel.com/docs/cli/tokens"}
{"@context":"https://schema.org","@type":"WebSite","name":"Vercel Documentation","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://lishhsx6kmthaacj.public.blob.vercel-storage.com/vercel-wordmark.svg"},"name":"Vercel Inc.","sameAs":["https://x.com/vercel","https://github.com/vercel/vercel","https://www.linkedin.com/company/vercel/","https://bsky.app/profile/vercel.com"],"url":"https://vercel.com/"},"url":"https://vercel.com/docs"}

[content]
vercel tokens
Skip to content
Copy Wordmark
Copy Logo
Download Brand Assets
Brand Guidelines
Docs
Build
Build with AI
AI Gateway
AI SDK
Sandbox
Container Registry
Workflow
Vercel Agent
v0
↗
Vercel MCP
AI Integrations
Deploy & scale
Deployments
CLI
Functions
Delivery Network
Storage
Integrations
Microfrontends
Domains
Operate & protect
Firewall
Observability
Feature Flags
Toolbar
Bot Management
BotID
Deployment Protection
Compliance
Learn
Resources
Changelog
↗
Blog
↗
Community
↗
Knowledge Base
APIs & SDKs
Templates
Getting Started
Ask AI
Log In
Sign Up
Build
Build with AI
AI Gateway
AI SDK
Sandbox
Container Registry
Workflow
Vercel Agent
v0
↗
Vercel MCP
AI Integrations
Deploy & scale
Deployments
CLI
Functions
Delivery Network
Storage
Integrations
Microfrontends
Domains
Operate & protect
Firewall
Observability
Feature Flags
Toolbar
Bot Management
BotID
Deployment Protection
Compliance
Learn
Resources
Changelog
↗
Blog
↗
Community
↗
Knowledge Base
APIs & SDKs
Templates
Getting Started
Ask AI
Sign Up
Log In
Search
Docs
⌘ K
Start
Getting started
Fundamentals
Frameworks
Incremental Migration
Production Checklist
Build AI apps
AI Gateway
AI SDK
MCP
Vercel Connect
beta
eve
beta
Agent Resources
Run agents and backends
Functions
Fluid Compute
Routing Middleware
Cron Jobs
Queues
beta
Workflows
Sandbox
Container Registry
beta
Ship and scale
Projects
Git
Drop
new
CLI
Monorepos
Builds
Deployments
Domains
Vercel for Platforms
Routing
CDN
Microfrontends
Storage
Integrations
Vercel Agent
Services
beta
Observe and improve
Observability
Vercel Toolbar
Feature Flags
Rolling Releases
Instant Rollback
Secure and govern
Firewall
Bot Management
BotID
Deployment Protection
Passport
new
Identity & Access
Networking
Security & Compliance
Manage
Pricing
Plans
Spend Management
Limits
Notifications
Support Center
Reference
Project Configuration
REST API
Vercel SDK
Build Output API
Webhooks
Marketplace APIs
Checks
Errors
Glossary
CLI
Overview
Deploying from CLI
Project Linking
Telemetry
Global Options
Release Notes
vercel activity
vercel agent
vercel ai-gateway
vercel alerts
vercel alias
vercel api
beta
vercel bisect
vercel blob
vercel build
vercel buy
vercel cache
vercel certs
vercel connect
beta
vercel contract
vercel crons
beta
vercel curl
beta
vercel deploy
vercel deploy-hooks
vercel dev
vercel dns
vercel domains
vercel env
vercel firewall
vercel flags
vercel git
vercel global-config
vercel guidance
vercel help
vercel httpstat
beta
vercel init
vercel inspect
vercel install
vercel integration
vercel link
vercel list
vercel login
vercel logout
vercel logs
vercel mcp
vercel metrics
vercel microfrontends
vercel oauth-apps
vercel open
vercel project
vercel promote
vercel pull
vercel redeploy
vercel redirects
vercel remove
vercel rollback
vercel rolling-release
vercel routes
vercel sandbox
vercel skills
vercel switch
vercel target
vercel teams
vercel telemetry
vercel tokens
vercel traces
vercel upgrade
vercel usage
vercel vcr
vercel webhooks
beta
vercel whoami
Copy page
Copy page
vercel tokens
Copy page
Copy page
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)
add (create)
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
add
"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
add
"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
add
"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.
Related
Account tokens
(Vercel Dashboard)
--token
global option
Using Vercel CLI for custom workflows
Global Options
The following
global options
can be passed when using the
vercel tokens
command:
--cwd
--debug
--global-config
--help
--local-config
--no-color
--non-interactive
--scope
--team
--token
--version
For more information on global options and their usage, refer to the
options section
.
Last updated
July 15, 2026
Previous
vercel telemetry
Next
vercel traces
Was this helpful?
supported.
Send
On this page
Usage
Commands
list (ls)
Options
add (create)
Arguments
Options
remove (rm, delete)
Arguments
Options
Examples
Create a token for CI/CD
Scope a token to a single project
List tokens as JSON
Revoke a token
Related
Global Options
CLI
vercel tokens
Agent Stack
AI SDK
AI Gateway
Sandbox
Workflows
Connect
New
Passport
New
eve
New
Core Platform
CI/CD
Content Delivery
Fluid Compute
Observability
Security
Platform Security
WAF
Bot Management
Bot ID
Tools
Vercel Drop
New
Vercel Agent
Vercel Plugin
New
Agent Skills
Next.js
Domains
v0
Frameworks
eve
New
Nuxt
SvelteKit
Nitro
Turborepo
Tanstack Start
FastAPI
xmcp
All frameworks
SDKs
Vercel SDK
Workflow SDK
New
Flags SDK
Chat SDK
New
Queues SDK
New
Streamdown
Build
AI Apps
Web Apps
Marketing Sites
Platforms
Commerce
Platform Engineers
Design Engineers
Learn
Docs
Blog
Changelog
Knowledge Base
Academy
Articles
Community
Explore
Customers
Marketplace
Templates
Partner Finder
Vercel + AWS
Company
About
Careers
Press
Events
Startups
Shipped on Vercel
Open Source Program
Enterprise
Pricing
Help
Legal & Trust
Privacy Policy
Terms of Service
Cookie Policy
DPA
Acceptable Use Policy
Legal (all documents)
Trust Center
Status
Cookie Preferences
Social
GitHub
X
LinkedIn
YouTube
Instagram
