Integrate with Vercel to manage deployments, projects, domains, DNS records, environment variables, aliases, edge configs, teams, and more.
List deployments for a Vercel project or team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | No | Filter deployments by project ID or name |
target | string | No | Filter by environment: production or staging |
state | string | No | Filter by state: BUILDING, ERROR, INITIALIZING, QUEUED, READY, CANCELED, BLOCKED |
app | string | No | Filter by deployment name |
since | number | No | Get deployments created after this JavaScript timestamp |
until | number | No | Get deployments created before this JavaScript timestamp |
limit | number | No | Maximum number of deployments to return per request |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
deployments | array | List of deployments |
count | number | Number of deployments returned |
hasMore | boolean | Whether more deployments are available |
Get details of a specific Vercel deployment
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | The unique deployment identifier or hostname |
withGitRepoInfo | string | No | Whether to add in gitRepo information (true/false) |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Deployment ID |
name | string | Deployment name |
url | string | Unique deployment URL |
readyState | string | Deployment ready state: QUEUED, BUILDING, ERROR, INITIALIZING, READY, CANCELED |
status | string | Deployment status |
target | string | Target environment |
createdAt | number | Creation timestamp in milliseconds |
buildingAt | number | Build start timestamp |
ready | number | Ready timestamp |
source | string | Deployment source: cli, git, redeploy, import, v0-web, etc. |
alias | array | Assigned aliases |
regions | array | Deployment regions |
inspectorUrl | string | Vercel inspector URL |
projectId | string | Associated project ID |
creator | object | Creator information |
project | object | Associated project |
meta | object | Deployment metadata (key-value strings) |
gitSource | object | Git source information |
errorCode | string | Deployment error code |
errorMessage | string | Deployment error message |
aliasAssigned | boolean | Whether the alias has been assigned |
Create a new deployment or redeploy an existing one
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
name | string | Yes | Project name for the deployment |
project | string | No | Project ID (overrides name for project lookup) |
deploymentId | string | No | Existing deployment ID to redeploy |
target | string | No | Target environment: production, staging, or a custom environment identifier |
gitSource | string | No | JSON string defining the Git Repository source to deploy (e.g. {"type":"github","repo":"owner/repo","ref":"main"}) |
forceNew | string | No | Forces a new deployment even if there is a previous similar deployment (0 or 1) |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Deployment ID |
name | string | Deployment name |
url | string | Unique deployment URL |
readyState | string | Deployment ready state: QUEUED, BUILDING, ERROR, INITIALIZING, READY, CANCELED |
projectId | string | Associated project ID |
createdAt | number | Creation timestamp in milliseconds |
alias | array | Assigned aliases |
target | string | Target environment |
inspectorUrl | string | Vercel inspector URL |
errorCode | string | Deployment error code |
errorMessage | string | Deployment error message |
aliasAssigned | boolean | Whether the alias has been assigned |
Cancel a running Vercel deployment
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | The deployment ID to cancel |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Deployment ID |
name | string | Deployment name |
state | string | Deployment state after cancellation |
url | string | Deployment URL |
status | string | Deployment status |
projectId | string | Associated project ID |
inspectorUrl | string | Vercel inspector URL |
Delete a Vercel deployment
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | The deployment ID or URL to delete |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
uid | string | The removed deployment ID |
state | string | Deployment state after deletion (DELETED) |
Get build and runtime events for a Vercel deployment
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | The unique deployment identifier or hostname |
direction | string | No | Order of events by timestamp: backward or forward (default: forward) |
follow | number | No | When set to 1, returns live events as they happen |
limit | number | No | Maximum number of events to return (-1 for all) |
since | number | No | Timestamp to start pulling build logs from |
until | number | No | Timestamp to stop pulling build logs at |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
events | array | List of deployment events |
count | number | Number of events returned |
List files in a Vercel deployment
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | The deployment ID to list files for |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
files | array | List of deployment files |
count | number | Number of files returned |
Promote a deployment by pointing the production deployment to the given deployment
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
deploymentId | string | Yes | The ID of the deployment to promote to production |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
promoted | boolean | Whether the deployment was promoted to production |
List all projects in a Vercel team or account
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
search | string | No | Search projects by name |
limit | number | No | Maximum number of projects to return |
from | string | No | Continuation token for pagination, taken from the previous response's pagination.next value. Query only projects updated after this timestamp or continuation token. |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
projects | array | List of projects |
count | number | Number of projects returned |
hasMore | boolean | Whether more projects are available |
nextFrom | string | Continuation token to pass as from to fetch the next page |
Get details of a specific Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Project ID |
name | string | Project name |
framework | string | Project framework |
rootDirectory | string | Root directory of the project |
nodeVersion | string | Node.js version |
createdAt | number | Creation timestamp |
updatedAt | number | Last updated timestamp |
link | object | Git repository connection |
Create a new Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
name | string | Yes | Project name |
framework | string | No | Project framework (e.g. nextjs, remix, vite) |
gitRepository | json | No | Git repository connection object with type and repo |
buildCommand | string | No | Custom build command |
outputDirectory | string | No | Custom output directory |
installCommand | string | No | Custom install command |
rootDirectory | string | No | Subdirectory of the repository the project lives in (for monorepos) |
nodeVersion | string | No | Node.js version to use (e.g. 22.x, 20.x, 18.x) |
devCommand | string | No | Custom dev server command |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Project ID |
name | string | Project name |
framework | string | Project framework |
createdAt | number | Creation timestamp |
updatedAt | number | Last updated timestamp |
Update an existing Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
name | string | No | New project name |
framework | string | No | Project framework (e.g. nextjs, remix, vite) |
buildCommand | string | No | Custom build command |
outputDirectory | string | No | Custom output directory |
installCommand | string | No | Custom install command |
rootDirectory | string | No | Subdirectory of the repository the project lives in (for monorepos) |
nodeVersion | string | No | Node.js version to use (e.g. 22.x, 20.x, 18.x) |
devCommand | string | No | Custom dev server command |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Project ID |
name | string | Project name |
framework | string | Project framework |
updatedAt | number | Last updated timestamp |
Delete a Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the project was successfully deleted |
Pause a Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Project ID |
name | string | Project name |
paused | boolean | Whether the project is paused |
Unpause a Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Project ID |
name | string | Project name |
paused | boolean | Whether the project is paused |
List all domains for a Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
limit | number | No | Maximum number of domains to return |
| Parameter | Type | Description |
|---|
domains | array | List of project domains |
count | number | Number of domains returned |
hasMore | boolean | Whether more domains are available |
Add a domain to a Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
domain | string | Yes | Domain name to add |
redirect | string | No | Target domain for redirect |
redirectStatusCode | number | No | HTTP status code for redirect (301, 302, 307, 308) |
gitBranch | string | No | Git branch to link the domain to |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
name | string | Domain name |
apexName | string | Apex domain name |
projectId | string | Project ID the domain belongs to |
verified | boolean | Whether the domain is verified |
gitBranch | string | Git branch for the domain |
redirect | string | Redirect target domain |
redirectStatusCode | number | HTTP status code for redirect (301, 302, 307, 308) |
verification | array | Domain verification challenges (type, domain, value, reason) |
createdAt | number | Creation timestamp |
updatedAt | number | Last updated timestamp |
Remove a domain from a Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
domain | string | Yes | Domain name to remove |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the domain was successfully removed |
Update a project domain's configuration on Vercel
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
domain | string | Yes | Domain name to update |
redirect | string | No | Target destination domain for redirect |
redirectStatusCode | number | No | HTTP status code for redirect (301, 302, 307, 308) |
gitBranch | string | No | Git branch to link the domain to |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
name | string | Domain name |
apexName | string | Apex domain name |
projectId | string | Project ID the domain belongs to |
verified | boolean | Whether the domain is verified |
redirect | string | Redirect target domain |
redirectStatusCode | number | HTTP status code for redirect (301, 302, 307, 308) |
gitBranch | string | Git branch for the domain |
verification | array | Domain verification challenges (type, domain, value, reason) |
createdAt | number | Creation timestamp |
updatedAt | number | Last updated timestamp |
Verify a Vercel project domain by checking its verification challenge
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
domain | string | Yes | Domain name to verify |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
name | string | Domain name |
apexName | string | Apex domain name |
projectId | string | Project ID |
verified | boolean | Whether the domain is verified |
redirect | string | Redirect target domain |
redirectStatusCode | number | Redirect status code (301, 302, 307, 308) |
gitBranch | string | Git branch linked to the domain |
createdAt | number | Creation timestamp |
updatedAt | number | Last update timestamp |
Retrieve environment variables for a Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
decrypt | boolean | No | If true, decrypted variable values are returned instead of ciphertext |
gitBranch | string | No | Filter results to the environment variables for this git branch (must have target=preview) |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
envs | array | List of environment variables |
count | number | Number of environment variables returned |
Create an environment variable for a Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
key | string | Yes | Environment variable name |
value | string | Yes | Environment variable value |
target | string | Yes | Comma-separated list of target environments (production, preview, development) |
type | string | No | Variable type: system, encrypted, plain, or sensitive (default: plain) |
gitBranch | string | No | Git branch to associate with the variable (requires target to include preview) |
comment | string | No | Comment to add context to the variable (max 500 characters) |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Environment variable ID |
key | string | Variable name |
value | string | Variable value |
type | string | Variable type (secret, system, encrypted, plain, sensitive) |
target | array | Target environments |
gitBranch | string | Git branch filter |
comment | string | Comment providing context for the variable |
createdAt | number | Creation timestamp |
updatedAt | number | Last update timestamp |
Update an environment variable for a Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
envId | string | Yes | Environment variable ID to update |
key | string | No | New variable name |
value | string | No | New variable value |
target | string | No | Comma-separated list of target environments (production, preview, development) |
type | string | No | Variable type: system, encrypted, plain, or sensitive |
gitBranch | string | No | Git branch to associate with the variable (requires target to include preview) |
comment | string | No | Comment to add context to the variable (max 500 characters) |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Environment variable ID |
key | string | Variable name |
value | string | Variable value |
type | string | Variable type (secret, system, encrypted, plain, sensitive) |
target | array | Target environments |
gitBranch | string | Git branch filter |
comment | string | Comment providing context for the variable |
createdAt | number | Creation timestamp |
updatedAt | number | Last update timestamp |
Delete an environment variable from a Vercel project
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | Yes | Project ID or name |
envId | string | Yes | Environment variable ID to delete |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the environment variable was successfully deleted |
List all domains in a Vercel account or team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
limit | number | No | Maximum number of domains to return (default 20) |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
domains | array | List of domains |
count | number | Number of domains returned |
hasMore | boolean | Whether more domains are available |
Get information about a specific domain in a Vercel account
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
domain | string | Yes | The domain name to retrieve |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Domain ID |
name | string | Domain name |
verified | boolean | Whether domain is verified |
createdAt | number | Creation timestamp |
expiresAt | number | Expiration timestamp |
serviceType | string | Service type (zeit.world, external, na) |
nameservers | array | Current nameservers |
intendedNameservers | array | Intended nameservers |
customNameservers | array | Custom nameservers |
renew | boolean | Whether auto-renewal is enabled |
boughtAt | number | Purchase timestamp |
transferredAt | number | Transfer completion timestamp |
creator | object | Domain creator (id, username, email) |
userId | string | Owner user ID |
teamId | string | Owner team ID |
transferStartedAt | number | Transfer start timestamp |
Add a new domain to a Vercel account or team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
name | string | Yes | The domain name to add |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Domain ID |
name | string | Domain name |
verified | boolean | Whether domain is verified |
createdAt | number | Creation timestamp |
serviceType | string | Service type (zeit.world, external, na) |
nameservers | array | Current nameservers |
intendedNameservers | array | Intended nameservers |
expiresAt | number | Expiration timestamp |
customNameservers | array | Custom nameservers |
renew | boolean | Whether auto-renewal is enabled |
boughtAt | number | Purchase timestamp |
transferredAt | number | Transfer completion timestamp |
creator | object | Domain creator (id, username, email) |
Delete a domain from a Vercel account or team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
domain | string | Yes | The domain name to delete |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
uid | string | The ID of the deleted domain |
deleted | boolean | Whether the domain was deleted |
Get the configuration for a domain in a Vercel account
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
domain | string | Yes | The domain name to get configuration for |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
configuredBy | string | How the domain is configured (CNAME, A, http, dns-01, or null) |
acceptedChallenges | array | Accepted challenge types for certificate issuance (dns-01, http-01) |
misconfigured | boolean | Whether the domain is misconfigured for TLS certificate generation |
recommendedIPv4 | array | Recommended IPv4 addresses with rank values |
recommendedCNAME | array | Recommended CNAME records with rank values |
List all DNS records for a domain in a Vercel account
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
domain | string | Yes | The domain name to list records for |
limit | number | No | Maximum number of records to return |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
records | array | List of DNS records |
count | number | Number of records returned |
hasMore | boolean | Whether more records are available |
Create a DNS record for a domain in a Vercel account
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
domain | string | Yes | The domain name to create the record for |
recordName | string | Yes | The subdomain or record name |
recordType | string | Yes | DNS record type (A, AAAA, ALIAS, CAA, CNAME, HTTPS, MX, SRV, TXT, NS) |
value | string | No | The value of the DNS record (not used for SRV/HTTPS records) |
ttl | number | No | Time to live in seconds |
mxPriority | number | No | Priority for MX records |
srvTarget | string | No | Target hostname for SRV records (required when recordType is SRV) |
srvWeight | number | No | Weight for SRV records (required when recordType is SRV) |
srvPort | number | No | Port for SRV records (required when recordType is SRV) |
srvPriority | number | No | Priority for SRV records (required when recordType is SRV) |
httpsTarget | string | No | Target hostname for HTTPS records (required when recordType is HTTPS) |
httpsPriority | number | No | Priority for HTTPS records (required when recordType is HTTPS) |
httpsParams | string | No | Optional service parameters for HTTPS records (e.g. "alpn=h2,h3") |
comment | string | No | A comment to add context on what this DNS record is for (max 500 characters) |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
uid | string | The DNS record ID |
updated | number | Timestamp of the update |
Update an existing DNS record for a domain in a Vercel account
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
recordId | string | Yes | The ID of the DNS record to update |
name | string | No | The name of the DNS record |
value | string | No | The value of the DNS record |
type | string | No | DNS record type (A, AAAA, ALIAS, CAA, CNAME, HTTPS, MX, SRV, TXT, NS) |
ttl | number | No | Time to live in seconds (60 to 2147483647) |
mxPriority | number | No | Priority for MX records |
srvTarget | string | No | Target hostname for SRV records (required together when updating SRV data) |
srvWeight | number | No | Weight for SRV records (required together when updating SRV data) |
srvPort | number | No | Port for SRV records (required together when updating SRV data) |
srvPriority | number | No | Priority for SRV records (required together when updating SRV data) |
httpsTarget | string | No | Target hostname for HTTPS records (required together when updating HTTPS data) |
httpsPriority | number | No | Priority for HTTPS records (required together when updating HTTPS data) |
httpsParams | string | No | Optional service parameters for HTTPS records (e.g. "alpn=h2,h3") |
comment | string | No | A comment to add context on what this DNS record is for (max 500 characters) |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | The DNS record ID |
name | string | The name of the DNS record |
type | string | The record class (record or record-sys) |
value | string | The value of the DNS record |
creator | string | The creator of the DNS record |
domain | string | The domain the record belongs to |
ttl | number | Time to live in seconds |
comment | string | Comment providing context for the record |
recordType | string | DNS record type (A, AAAA, ALIAS, CAA, CNAME, HTTPS, MX, NS, SRV, TXT) |
createdAt | number | Timestamp of record creation |
Delete a DNS record for a domain in a Vercel account
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
domain | string | Yes | The domain name the record belongs to |
recordId | string | Yes | The ID of the DNS record to delete |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the record was deleted |
List aliases for a Vercel project or team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | No | Filter aliases by project ID |
domain | string | No | Filter aliases by domain |
limit | number | No | Maximum number of aliases to return |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
aliases | array | List of aliases |
count | number | Number of aliases returned |
hasMore | boolean | Whether more aliases are available |
Get details about a specific alias by ID or hostname
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
aliasId | string | Yes | Alias ID or hostname to look up |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
uid | string | Alias ID |
alias | string | Alias hostname |
deploymentId | string | Associated deployment ID |
projectId | string | Associated project ID |
createdAt | number | Creation timestamp in milliseconds |
updatedAt | number | Last update timestamp in milliseconds |
redirect | string | Target domain for redirect aliases |
redirectStatusCode | number | HTTP status code for redirect (301, 302, 307, or 308) |
deployment | object | Associated deployment (id, url) |
Assign an alias (domain/subdomain) to a deployment
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | Deployment ID to assign the alias to |
alias | string | Yes | The domain or subdomain to assign as an alias |
redirect | string | No | Hostname to 307-redirect the alias to instead of serving the deployment directly |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
uid | string | Alias ID |
alias | string | Alias hostname |
created | string | Creation timestamp as ISO 8601 date-time string |
oldDeploymentId | string | ID of the previously aliased deployment, if the alias was reassigned |
Delete an alias by its ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
aliasId | string | Yes | Alias ID to delete |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
status | string | Deletion status (SUCCESS) |
List all Edge Config stores for a team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
teamId | string | No | Team ID to scope the request |
| Parameter | Type | Description |
|---|
edgeConfigs | array | List of Edge Config stores |
count | number | Number of Edge Configs returned |
Get details about a specific Edge Config store
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
edgeConfigId | string | Yes | Edge Config ID to look up |
teamId | string | No | Team ID to scope the request |
| Parameter | Type | Description |
|---|
id | string | Edge Config ID |
slug | string | Edge Config slug |
ownerId | string | Owner ID |
digest | string | Content digest hash |
createdAt | number | Creation timestamp |
updatedAt | number | Last update timestamp |
itemCount | number | Number of items |
sizeInBytes | number | Size in bytes |
Create a new Edge Config store
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
slug | string | Yes | The name/slug for the new Edge Config |
teamId | string | No | Team ID to scope the request |
| Parameter | Type | Description |
|---|
id | string | Edge Config ID |
slug | string | Edge Config slug |
ownerId | string | Owner ID |
digest | string | Content digest hash |
createdAt | number | Creation timestamp |
updatedAt | number | Last update timestamp |
itemCount | number | Number of items |
sizeInBytes | number | Size in bytes |
Get all items in an Edge Config store
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
edgeConfigId | string | Yes | Edge Config ID to get items from |
teamId | string | No | Team ID to scope the request |
| Parameter | Type | Description |
|---|
items | array | List of Edge Config items |
count | number | Number of items returned |
Create, update, upsert, or delete items in an Edge Config store
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
edgeConfigId | string | Yes | Edge Config ID to update items in |
items | json | Yes | Array of operations: [{operation: "create"|"update"|"upsert"|"delete", key: string, value?: any}] |
teamId | string | No | Team ID to scope the request |
| Parameter | Type | Description |
|---|
status | string | Operation status |
Delete an Edge Config store by ID
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
edgeConfigId | string | Yes | Edge Config ID to delete |
teamId | string | No | Team ID to scope the request |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the Edge Config was successfully deleted |
List webhooks for a Vercel project or team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
projectId | string | No | Filter webhooks by project ID |
teamId | string | No | Team ID to scope the request |
| Parameter | Type | Description |
|---|
webhooks | array | List of webhooks |
count | number | Number of webhooks returned |
Get details about a specific Vercel webhook
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
webhookId | string | Yes | Webhook ID to look up |
teamId | string | No | Team ID to scope the request |
| Parameter | Type | Description |
|---|
id | string | Webhook ID |
url | string | Webhook URL |
events | array | Events the webhook listens to |
ownerId | string | Owner ID |
projectIds | array | Associated project IDs |
createdAt | number | Creation timestamp |
updatedAt | number | Last updated timestamp |
Create a new webhook for a Vercel team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
url | string | Yes | Webhook URL (must be https) |
events | string | Yes | Comma-separated event names to subscribe to |
projectIds | string | No | Comma-separated project IDs to scope the webhook to |
teamId | string | No | Team ID to scope the webhook to (optional; omit for personal account) |
| Parameter | Type | Description |
|---|
id | string | Webhook ID |
url | string | Webhook URL |
secret | string | Webhook signing secret |
events | array | Events the webhook listens to |
ownerId | string | Owner ID |
projectIds | array | Associated project IDs |
createdAt | number | Creation timestamp |
updatedAt | number | Last updated timestamp |
Delete a webhook from a Vercel team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
webhookId | string | Yes | The webhook ID to delete |
teamId | string | No | Team ID to scope the request |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the webhook was successfully deleted |
Create a new deployment check
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | Deployment ID to create the check for |
name | string | Yes | Name of the check (max 100 characters) |
blocking | boolean | Yes | Whether the check blocks the deployment |
path | string | No | Page path being checked |
detailsUrl | string | No | URL with details about the check |
externalId | string | No | External identifier for the check |
rerequestable | boolean | No | Whether the check can be rerequested |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Check ID |
name | string | Check name |
status | string | Check status: registered, running, or completed |
conclusion | string | Check conclusion: canceled, failed, neutral, succeeded, skipped, or stale |
blocking | boolean | Whether the check blocks the deployment |
deploymentId | string | Associated deployment ID |
integrationId | string | Associated integration ID |
externalId | string | External identifier |
detailsUrl | string | URL with details about the check |
path | string | Page path being checked |
rerequestable | boolean | Whether the check can be rerequested |
createdAt | number | Creation timestamp in milliseconds |
updatedAt | number | Last update timestamp in milliseconds |
startedAt | number | Start timestamp in milliseconds |
completedAt | number | Completion timestamp in milliseconds |
output | json | Check result output including metrics (FCP, LCP, CLS, TBT, virtualExperienceScore) |
Get details of a specific deployment check
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | Deployment ID the check belongs to |
checkId | string | Yes | Check ID to retrieve |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Check ID |
name | string | Check name |
status | string | Check status: registered, running, or completed |
conclusion | string | Check conclusion: canceled, failed, neutral, succeeded, skipped, or stale |
blocking | boolean | Whether the check blocks the deployment |
deploymentId | string | Associated deployment ID |
integrationId | string | Associated integration ID |
externalId | string | External identifier |
detailsUrl | string | URL with details about the check |
path | string | Page path being checked |
rerequestable | boolean | Whether the check can be rerequested |
createdAt | number | Creation timestamp in milliseconds |
updatedAt | number | Last update timestamp in milliseconds |
startedAt | number | Start timestamp in milliseconds |
completedAt | number | Completion timestamp in milliseconds |
output | json | Check result output including metrics (FCP, LCP, CLS, TBT, virtualExperienceScore) |
List all checks for a deployment
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | Deployment ID to list checks for |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
checks | array | List of deployment checks |
count | number | Total number of checks |
Update an existing deployment check
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | Deployment ID the check belongs to |
checkId | string | Yes | Check ID to update |
name | string | No | Updated name of the check |
status | string | No | Updated status: running or completed |
conclusion | string | No | Check conclusion: canceled, failed, neutral, succeeded, or skipped |
detailsUrl | string | No | URL with details about the check |
externalId | string | No | External identifier for the check |
path | string | No | Page path being checked |
output | string | No | JSON string with check output metrics |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
| Parameter | Type | Description |
|---|
id | string | Check ID |
name | string | Check name |
status | string | Check status: registered, running, or completed |
conclusion | string | Check conclusion: canceled, failed, neutral, succeeded, skipped, or stale |
blocking | boolean | Whether the check blocks the deployment |
deploymentId | string | Associated deployment ID |
integrationId | string | Associated integration ID |
externalId | string | External identifier |
detailsUrl | string | URL with details about the check |
path | string | Page path being checked |
rerequestable | boolean | Whether the check can be rerequested |
createdAt | number | Creation timestamp in milliseconds |
updatedAt | number | Last update timestamp in milliseconds |
startedAt | number | Start timestamp in milliseconds |
completedAt | number | Completion timestamp in milliseconds |
output | json | Check result output including metrics (FCP, LCP, CLS, TBT, virtualExperienceScore) |
Rerequest a deployment check
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
deploymentId | string | Yes | Deployment ID the check belongs to |
checkId | string | Yes | Check ID to rerequest |
teamId | string | No | Team ID to scope the request |
slug | string | No | Team slug to scope the request (alternative to teamId) |
autoUpdate | boolean | No | Whether to mark the check as running immediately on rerequest |
| Parameter | Type | Description |
|---|
rerequested | boolean | Whether the check was successfully rerequested |
List all teams in a Vercel account
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
limit | number | No | Maximum number of teams to return |
since | number | No | Timestamp in milliseconds to only include teams created since then |
until | number | No | Timestamp in milliseconds to only include teams created until then |
| Parameter | Type | Description |
|---|
teams | array | List of teams |
count | number | Number of teams returned |
pagination | object | Pagination information |
Get information about a specific Vercel team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
teamId | string | Yes | The team ID to retrieve |
| Parameter | Type | Description |
|---|
id | string | Team ID |
slug | string | Team slug |
name | string | Team name |
avatar | string | Avatar file ID |
description | string | Short team description |
stagingPrefix | string | Prefix used for staging deployments |
createdAt | number | Creation timestamp in milliseconds |
updatedAt | number | Last update timestamp in milliseconds |
creatorId | string | User ID of team creator |
membership | object | Current user membership details |
List all members of a Vercel team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
teamId | string | Yes | The team ID to list members for |
limit | number | No | Maximum number of members to return |
role | string | No | Filter by role (OWNER, MEMBER, DEVELOPER, SECURITY, BILLING, VIEWER, VIEWER_FOR_PLUS, CONTRIBUTOR) |
since | number | No | Timestamp in milliseconds to only include members added since then |
until | number | No | Timestamp in milliseconds to only include members added until then |
search | string | No | Search team members by their name, username, and email |
| Parameter | Type | Description |
|---|
members | array | List of team members |
count | number | Number of members returned |
pagination | object | Pagination information |
Get information about the authenticated Vercel user
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Vercel Access Token |
| Parameter | Type | Description |
|---|
id | string | User ID |
email | string | User email |
username | string | Username |
name | string | Display name |
avatar | string | SHA1 hash of the avatar |
defaultTeamId | string | Default team ID |
createdAt | number | Account creation timestamp in milliseconds |
stagingPrefix | string | Prefix for preview deployment URLs |
softBlock | object | Account restriction details if blocked |
hasTrialAvailable | boolean | Whether a trial is available |
Trigger workflow when a new deployment is created
| Parameter | Type | Description |
|---|
type | string | Event type (e.g., deployment.created) |
id | string | Unique webhook delivery ID (string) |
createdAt | number | Event timestamp in milliseconds |
region | string | Region where the event occurred |
payload | json | Raw event payload from Vercel |
links.deployment | string | Vercel Dashboard URL for the deployment |
links.project | string | Vercel Dashboard URL for the project |
regions | json | Regions associated with the deployment (array), when provided by Vercel |
deployment.id | string | Deployment ID |
deployment.url | string | Deployment URL |
deployment.name | string | Deployment name |
deployment.meta | json | Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API |
project.id | string | Project ID |
project.name | string | Project name |
team.id | string | Team ID |
user.id | string | User ID |
target | string | Deployment target (production, staging, or preview) |
plan | string | Account plan type |
domain.name | string | Domain name |
domain.delegated | boolean | Whether the domain was delegated/shared when present on the payload |
Trigger workflow when a deployment is ready to serve traffic
| Parameter | Type | Description |
|---|
type | string | Event type (e.g., deployment.created) |
id | string | Unique webhook delivery ID (string) |
createdAt | number | Event timestamp in milliseconds |
region | string | Region where the event occurred |
payload | json | Raw event payload from Vercel |
links.deployment | string | Vercel Dashboard URL for the deployment |
links.project | string | Vercel Dashboard URL for the project |
regions | json | Regions associated with the deployment (array), when provided by Vercel |
deployment.id | string | Deployment ID |
deployment.url | string | Deployment URL |
deployment.name | string | Deployment name |
deployment.meta | json | Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API |
project.id | string | Project ID |
project.name | string | Project name |
team.id | string | Team ID |
user.id | string | User ID |
target | string | Deployment target (production, staging, or preview) |
plan | string | Account plan type |
domain.name | string | Domain name |
domain.delegated | boolean | Whether the domain was delegated/shared when present on the payload |
Trigger workflow when a deployment fails
| Parameter | Type | Description |
|---|
type | string | Event type (e.g., deployment.created) |
id | string | Unique webhook delivery ID (string) |
createdAt | number | Event timestamp in milliseconds |
region | string | Region where the event occurred |
payload | json | Raw event payload from Vercel |
links.deployment | string | Vercel Dashboard URL for the deployment |
links.project | string | Vercel Dashboard URL for the project |
regions | json | Regions associated with the deployment (array), when provided by Vercel |
deployment.id | string | Deployment ID |
deployment.url | string | Deployment URL |
deployment.name | string | Deployment name |
deployment.meta | json | Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API |
project.id | string | Project ID |
project.name | string | Project name |
team.id | string | Team ID |
user.id | string | User ID |
target | string | Deployment target (production, staging, or preview) |
plan | string | Account plan type |
domain.name | string | Domain name |
domain.delegated | boolean | Whether the domain was delegated/shared when present on the payload |
Trigger workflow when a deployment is canceled
| Parameter | Type | Description |
|---|
type | string | Event type (e.g., deployment.created) |
id | string | Unique webhook delivery ID (string) |
createdAt | number | Event timestamp in milliseconds |
region | string | Region where the event occurred |
payload | json | Raw event payload from Vercel |
links.deployment | string | Vercel Dashboard URL for the deployment |
links.project | string | Vercel Dashboard URL for the project |
regions | json | Regions associated with the deployment (array), when provided by Vercel |
deployment.id | string | Deployment ID |
deployment.url | string | Deployment URL |
deployment.name | string | Deployment name |
deployment.meta | json | Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API |
project.id | string | Project ID |
project.name | string | Project name |
team.id | string | Team ID |
user.id | string | User ID |
target | string | Deployment target (production, staging, or preview) |
plan | string | Account plan type |
domain.name | string | Domain name |
domain.delegated | boolean | Whether the domain was delegated/shared when present on the payload |
Trigger workflow when a new project is created
| Parameter | Type | Description |
|---|
type | string | Event type (e.g., deployment.created) |
id | string | Unique webhook delivery ID (string) |
createdAt | number | Event timestamp in milliseconds |
region | string | Region where the event occurred |
payload | json | Raw event payload from Vercel |
links.deployment | string | Vercel Dashboard URL for the deployment |
links.project | string | Vercel Dashboard URL for the project |
regions | json | Regions associated with the deployment (array), when provided by Vercel |
deployment.id | string | Deployment ID |
deployment.url | string | Deployment URL |
deployment.name | string | Deployment name |
deployment.meta | json | Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API |
project.id | string | Project ID |
project.name | string | Project name |
team.id | string | Team ID |
user.id | string | User ID |
target | string | Deployment target (production, staging, or preview) |
plan | string | Account plan type |
domain.name | string | Domain name |
domain.delegated | boolean | Whether the domain was delegated/shared when present on the payload |
Trigger workflow when a project is removed
| Parameter | Type | Description |
|---|
type | string | Event type (e.g., deployment.created) |
id | string | Unique webhook delivery ID (string) |
createdAt | number | Event timestamp in milliseconds |
region | string | Region where the event occurred |
payload | json | Raw event payload from Vercel |
links.deployment | string | Vercel Dashboard URL for the deployment |
links.project | string | Vercel Dashboard URL for the project |
regions | json | Regions associated with the deployment (array), when provided by Vercel |
deployment.id | string | Deployment ID |
deployment.url | string | Deployment URL |
deployment.name | string | Deployment name |
deployment.meta | json | Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API |
project.id | string | Project ID |
project.name | string | Project name |
team.id | string | Team ID |
user.id | string | User ID |
target | string | Deployment target (production, staging, or preview) |
plan | string | Account plan type |
domain.name | string | Domain name |
domain.delegated | boolean | Whether the domain was delegated/shared when present on the payload |
Trigger workflow when a domain is created
| Parameter | Type | Description |
|---|
type | string | Event type (e.g., deployment.created) |
id | string | Unique webhook delivery ID (string) |
createdAt | number | Event timestamp in milliseconds |
region | string | Region where the event occurred |
payload | json | Raw event payload from Vercel |
links.deployment | string | Vercel Dashboard URL for the deployment |
links.project | string | Vercel Dashboard URL for the project |
regions | json | Regions associated with the deployment (array), when provided by Vercel |
deployment.id | string | Deployment ID |
deployment.url | string | Deployment URL |
deployment.name | string | Deployment name |
deployment.meta | json | Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API |
target | string | Deployment target (production, staging, or preview) |
plan | string | Account plan type |
domain.name | string | Domain name |
domain.delegated | boolean | Whether the domain was delegated/shared (domain.created), per Vercel Webhooks API |
project.id | string | Project ID |
team.id | string | Team ID |
user.id | string | User ID |
Trigger on a curated set of common Vercel events (deployments, projects, domains, edge config). Pick a specific trigger to listen to one event type only.
| Parameter | Type | Description |
|---|
type | string | Event type (e.g., deployment.created) |
id | string | Unique webhook delivery ID (string) |
createdAt | number | Event timestamp in milliseconds |
region | string | Region where the event occurred |
payload | json | Full event payload |
links.deployment | string | Vercel Dashboard URL for the deployment |
links.project | string | Vercel Dashboard URL for the project |
regions | json | Regions associated with the deployment (array), when provided by Vercel |
deployment.id | string | Deployment ID |
deployment.url | string | Deployment URL |
deployment.name | string | Deployment name |
deployment.meta | json | Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API |
project.id | string | Project ID |
project.name | string | Project name |
team.id | string | Team ID |
user.id | string | User ID |
target | string | Deployment target (production, staging, or preview) |
plan | string | Account plan type |
domain.name | string | Domain name |
domain.delegated | boolean | Whether the domain was delegated/shared when present on the payload |
- Category:
tools
- Type:
vercel