Vercel
Arcade Optimized
Arcade.dev tools for interacting with Vercel
Author:Arcade
Version:
1.0.4Auth:No authentication required
23tools
23require secrets
Vercel Toolkit for Arcade
Provides Arcade tools for managing Vercel projects, deployments, domains, and configuration via the Vercel REST API. Use it to automate the full deployment lifecycle — from project creation through production promotion and rollback — without leaving your AI workflow.
Capabilities
- Project management: Create, retrieve, update settings for, and permanently delete projects; list and fuzzy-search across all projects in scope.
- Deployment lifecycle: Trigger deployments from inline files, connected Git repos, or prior deployments; cancel in-progress builds; inspect state and metadata; read build and runtime logs.
- Production promotion and rollback: Instantly promote an existing production-targeted build or rebuild a preview as a new production deployment; roll back production to any prior deployment.
- Environment variables: List, create, update, and delete per-project environment variables across all environments; note that changes take effect only after a new deployment.
- Custom domains: Attach and detach domains, inspect DNS-configuration and verification status, and trigger re-verification with challenge record details surfaced on failure.
- Account and team context: Resolve the authenticated account identity and enumerate accessible teams (with billing plan details) to confirm scope before making changes.
Secrets
VERCEL_ACCESS_TOKEN — A Vercel personal access token (or team-scoped token) that authenticates all API requests. To obtain one: log in to the Vercel dashboard, navigate to Account Settings → Tokens, and create a new token. Choose an appropriate expiry. If you are operating on a team scope, ensure the token belongs to an account that is a member of that team with sufficient permissions (at minimum, the ability to read and write projects and deployments). Vercel's own documentation for token creation is at https://vercel.com/docs/rest-api#authentication.
Store secrets in Arcade at https://api.arcade.dev/dashboard/auth/secrets. For general guidance on secrets in Arcade tools, see https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets.
Available tools(23)
23 of 23 tools
Operations
Behavior
| Tool name | Description | Secrets | |
|---|---|---|---|
Attach a custom domain to a project; the result reports its verification status. | 1 | ||
Cancel an in-progress deployment.
Canceling a deployment that has already finished is not an error: its current (terminal) state
is returned unchanged rather than reporting a cancellation. | 1 | ||
Trigger a new deployment from inline source files, a git repository, or a prior deployment.
The target project must already exist (create it first); an unknown project name or id is
rejected rather than silently auto-created. Exactly one source is required: pass files to
upload source inline (no Git connection needed, the way to ship a first deployment on an
account without a connected repository), git_repo together with git_ref to deploy from a
connected repository, or redeploy_of to rebuild a prior deployment's source. Deploying from a
repository requires the Vercel account to have a connected Git integration for that provider. | 1 | ||
Create a new project, optionally connecting a git repository to deploy from. | 1 | ||
Delete an environment variable from a project. | 1 | ||
Permanently delete a project and all of its deployments. | 1 | ||
Return the Vercel account the access token authenticates as.
Call this first in a session to confirm which account you are acting on
before making any changes. | 1 | ||
Return a single deployment's state and metadata. | 1 | ||
Read a deployment's build and runtime log events to diagnose why it failed. | 1 | ||
Return a single project's settings and latest deployment state. | 1 | ||
Return a project domain's verification status and DNS-configuration state. | 1 | ||
Return a team's details, including its billing plan. | 1 | ||
List deployments in the active scope, optionally filtered by project, target, and state. | 1 | ||
List a project's environment variables across all environments. | 1 | ||
List the custom domains attached to a project. | 1 | ||
List the projects in the active scope, optionally narrowed by a fuzzy name search. | 1 | ||
List the teams the access token can act on, to discover a valid team scope. | 1 | ||
Make a deployment the project's current production deployment ("ship this one").
A deployment that already targeted production (a staged or prior production build) is
promoted instantly without a rebuild. A preview deployment cannot be aliased to production
directly, because preview and production builds can differ (e.g. environment variables), so
this rebuilds the preview's source as a new production deployment — the same complete-rebuild
path the Vercel dashboard uses to promote a preview. In that case the returned deployment is
the new build (still building), not the preview that was passed in. | 1 | ||
Detach a custom domain from a project. | 1 | ||
Roll production back to a prior deployment, making it the current production deployment. | 1 | ||
Create or update a project environment variable.
Omit env_id to create (key, value, and target are required); pass env_id to update an existing
variable in place, changing only the fields you supply. Saving a variable does not affect
already-built deployments: a new deployment must be triggered for the change to take effect. | 1 | ||
Update a project's build and framework settings; unset fields are left unchanged. | 1 | ||
Trigger verification of a project domain and return its resulting status.
An unmet DNS challenge is the normal polling path, not an error: this returns the domain's
still-unverified status (with the outstanding challenge records) rather than failing. | 1 |
Last updated on