Skip to main content
Vercel logo

Overview

Add Vercel to any ModuleX agent or workflow. Manage Vercel deployments, projects, domains, DNS records, environment variables, aliases, edge configs, teams, webhooks, and deployment checks through the Vercel REST API (api.vercel.com).
Categories: Developer Tools & Infrastructure · Cloud Infrastructure · Tools · Auth: API Key · Actions: 56

Authentication

API Key Authentication

Authenticate using your Vercel Access Token
1

Step 1

Sign in at https://vercel.com and open Account Settings → Tokens
2

Step 2

Click ‘Create Token’, enter a name and (recommended) an expiration
3

Step 3

Copy the generated token (it is shown only once)
4

Step 4

Paste the token below

Required Credentials

Available Actions

Parameters

string
Filter deployments by project ID or name
string
Filter by environment: production or staging
string
Filter by state: BUILDING, ERROR, INITIALIZING, QUEUED, READY, CANCELED, BLOCKED
string
Filter by deployment name
integer
Get deployments created after this timestamp
integer
Get deployments created before this timestamp
integer
Maximum number of deployments to return
string
Team ID to scope the request

Response

Parameters

string
required
The unique deployment identifier or hostname
string
Whether to add gitRepo information (true/false)
string
Team ID to scope the request

Response

Parameters

string
required
Project name for the deployment
string
Project ID (overrides name for project lookup)
string
Existing deployment ID to redeploy
string
Target environment: production, staging, or a custom environment
object
Git Repository source to deploy (e.g. {“type”:“github”,“repo”:“owner/repo”,“ref”:“main”})
string
Force a new deployment even if a similar one exists (0 or 1)
string
Team ID to scope the request

Response

Parameters

string
required
The deployment ID to cancel
string
Team ID to scope the request

Response

Parameters

string
required
The deployment ID or URL to delete
string
Team ID to scope the request

Response

Parameters

string
required
The unique deployment identifier or hostname
string
Order of events by timestamp: backward or forward
integer
When set to 1, returns live events as they happen
integer
Maximum number of events to return (-1 for all)
integer
Timestamp to start pulling build logs from
integer
Timestamp to stop pulling build logs at
string
Team ID to scope the request

Response

Parameters

string
required
The deployment ID to list files for
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
required
The ID of the deployment to promote to production
string
Team ID to scope the request

Response

Parameters

Search projects by name
integer
Maximum number of projects to return
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
Team ID to scope the request

Response

Parameters

string
required
Project name
string
Project framework (e.g. nextjs, remix, vite)
object
Git repository connection object with type and repo
string
Custom build command
string
Custom output directory
string
Custom install command
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
New project name
string
Project framework (e.g. nextjs, remix, vite)
string
Custom build command
string
Custom output directory
string
Custom install command
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
Team ID to scope the request
integer
Maximum number of domains to return

Response

Parameters

string
required
Project ID or name
string
required
Domain name to add
string
Target domain for redirect
integer
HTTP status code for redirect (301, 302, 307, 308)
string
Git branch to link the domain to
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
required
Domain name to update
string
Target destination domain for redirect
integer
HTTP status code for redirect (301, 302, 307, 308)
string
Git branch to link the domain to
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
required
Domain name to verify
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
required
Domain name to remove
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
required
Environment variable name
string
required
Environment variable value
string
required
Comma-separated target environments (production, preview, development)
string
Variable type: system, encrypted, plain, or sensitive (Default: plain)
string
Git branch to associate (requires target to include preview)
string
Comment to add context (max 500 characters)
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
required
Environment variable ID to update
string
New variable name
string
New variable value
string
Comma-separated target environments (production, preview, development)
string
Variable type: system, encrypted, plain, or sensitive
string
Git branch to associate (requires target to include preview)
string
Comment to add context (max 500 characters)
string
Team ID to scope the request

Response

Parameters

string
required
Project ID or name
string
required
Environment variable ID to delete
string
Team ID to scope the request

Response

Parameters

integer
Maximum number of domains to return
string
Team ID to scope the request

Response

Parameters

string
required
The domain name to retrieve
string
Team ID to scope the request

Response

Parameters

string
required
The domain name to add
string
Team ID to scope the request

Response

Parameters

string
required
The domain name to delete
string
Team ID to scope the request

Response

Parameters

string
required
The domain name to get configuration for
string
Team ID to scope the request

Response

Parameters

string
required
The domain name to list records for
integer
Maximum number of records to return
string
Team ID to scope the request

Response

Parameters

string
required
The domain name to create the record for
string
required
The subdomain or record name
string
required
DNS record type (A, AAAA, ALIAS, CAA, CNAME, HTTPS, MX, SRV, TXT, NS)
string
required
The value of the DNS record
integer
Time to live in seconds
integer
Priority for MX records
string
Team ID to scope the request

Response

Parameters

string
required
The ID of the DNS record to update
string
The name of the DNS record
string
The value of the DNS record
string
DNS record type (A, AAAA, ALIAS, CAA, CNAME, HTTPS, MX, SRV, TXT, NS)
integer
Time to live in seconds (60 to 2147483647)
integer
Priority for MX records
string
Comment to add context (max 500 characters)
string
Team ID to scope the request

Response

Parameters

string
required
The domain name the record belongs to
string
required
The ID of the DNS record to delete
string
Team ID to scope the request

Response

Parameters

string
Filter aliases by project ID
string
Filter aliases by domain
integer
Maximum number of aliases to return
string
Team ID to scope the request

Response

Parameters

string
required
Alias ID or hostname to look up
string
Team ID to scope the request

Response

Parameters

string
required
Deployment ID to assign the alias to
string
required
The domain or subdomain to assign as an alias
string
Team ID to scope the request

Response

Parameters

string
required
Alias ID to delete
string
Team ID to scope the request

Response

Parameters

string
Team ID to scope the request

Response

Parameters

string
required
Edge Config ID to look up
string
Team ID to scope the request

Response

Parameters

string
required
The name/slug for the new Edge Config
string
Team ID to scope the request

Response

Parameters

string
required
Edge Config ID to get items from
string
Team ID to scope the request

Response

Parameters

string
required
Edge Config ID to update items in
array
required
Array of operations: [{“operation”: “create|update|upsert|delete”, “key”: ”…”, “value”: …}]
string
Team ID to scope the request

Response

Parameters

string
required
Edge Config ID to delete
string
Team ID to scope the request

Response

Parameters

string
Filter webhooks by project ID
string
Team ID to scope the request

Response

Parameters

string
required
Webhook ID to look up
string
Team ID to scope the request

Response

Parameters

string
required
Webhook URL (must be https)
string
required
Comma-separated event names to subscribe to
string
Comma-separated project IDs to scope the webhook to
string
Team ID to scope the request

Response

Parameters

string
required
The webhook ID to delete
string
Team ID to scope the request

Response

Parameters

string
required
Deployment ID to create the check for
string
required
Name of the check (max 100 characters)
boolean
required
Whether the check blocks the deployment
string
Page path being checked
string
URL with details about the check
string
External identifier for the check
boolean
Whether the check can be rerequested
string
Team ID to scope the request

Response

Parameters

string
required
Deployment ID the check belongs to
string
required
Check ID to retrieve
string
Team ID to scope the request

Response

Parameters

string
required
Deployment ID to list checks for
string
Team ID to scope the request

Response

Parameters

string
required
Deployment ID the check belongs to
string
required
Check ID to update
string
Updated name of the check
string
Updated status: running or completed
string
Check conclusion: canceled, failed, neutral, succeeded, or skipped
string
URL with details about the check
string
External identifier for the check
string
Page path being checked
object
Check output metrics object
string
Team ID to scope the request

Response

Parameters

string
required
Deployment ID the check belongs to
string
required
Check ID to rerequest
string
Team ID to scope the request

Response

Parameters

integer
Maximum number of teams to return
integer
Only include teams created since this timestamp (ms)
integer
Only include teams created until this timestamp (ms)

Response

Parameters

string
required
The team ID to retrieve

Response

Parameters

string
required
The team ID to list members for
integer
Maximum number of members to return
string
Filter by role (OWNER, MEMBER, DEVELOPER, SECURITY, BILLING, VIEWER, CONTRIBUTOR)
integer
Only include members added since this timestamp (ms)
integer
Only include members added until this timestamp (ms)
string
Search members by name, username, and email

Response

Response

Limits & Quotas

  • Rate limits: the Vercel REST API enforces per-endpoint rate limits; on 429 the response carries a Retry-After header. Plan for retries on the agent side based on the error string.
  • API versioning: each endpoint pins its own version in the path (e.g. /v13/deployments, /v9/projects, /v2/teams, /v1/edge-config); these are preserved as documented by Vercel.
  • Error model: non-2xx responses and timeouts are caught and returned as success=False + error rather than raising.

Amazon Web Services

Google Cloud

Algolia