Vercel Deployments icon

Vercel Deployments

Manage Vercel deployments via the Vercel REST API

Actions8

List Deployments

AI-generated

Summary

Lists Vercel deployments via GET /v6/deployments, optionally filtered by state, target, and project ID, and returns the raw API response for each input item.

Inputs

  • State — Filter by deployment state (BUILDING, READY, ERROR, QUEUED, CANCELED, INITIALIZING). Default 'All' sends no filter.
  • Target — Filter by Production or Preview. Default 'All' sends no filter.
  • Project ID (filter) — Only return deployments for this project ID. Ignored when empty.
  • Limit — Maximum number of deployments to return, 1–100 (default 20). Sent as the limit query parameter; no pagination is performed.

Output shape

One output item per input item, whose json is the Vercel API response body (typically an object with a deployments array and pagination info).

Only a single request is made per item, so results beyond the limit are not fetched. The team ID from the credentials (or a teamIdOverride parameter, if present) is added as the teamId query parameter. With Continue On Fail enabled, errors are returned as { error: message } items.

Examples

Example 1: Fetch the 50 most recent production deployments of a project that failed

State=ERROR, Target=Production, Project ID=prj_xxx, Limit=50

Example 2: Check for builds currently in progress

State=BUILDING, other filters left at defaults, Limit=20

Links

Discussion