Vercel Deployments icon

Vercel Deployments

Manage Vercel deployments via the Vercel REST API

Actions8

Cancel Deployment

AI-generated

Summary

Cancels an in-progress Vercel deployment by sending a PATCH request to the Vercel API's /v12/deployments/{idOrUrl}/cancel endpoint, and returns the API's response.

Inputs

  • Deployment ID or URL (required) — The deployment ID or URL to cancel. It is URL-encoded and inserted into the request path.

Output shape

One output item per input item, with the JSON body returned by Vercel's cancel endpoint (typically the updated deployment object) in json.

The request uses the team ID from the credentials, or a teamIdOverride parameter if one is set, as the teamId query string. The source reads teamIdOverride, but it isn't declared in this operation's properties. If a request fails and Continue On Fail is enabled, the item contains { error: message } instead. Otherwise the node throws an error.

Examples

Example 1: Cancel a stuck or unwanted build after a newer commit is pushed.

Operation: Cancel Deployment; Deployment ID or URL: {{ $json.deploymentId }} (e.g. dpl_abc123).

Example 2: Cancel a deployment found by an earlier List Deployments step that filtered on state BUILDING.

Operation: Cancel Deployment; Deployment ID or URL: {{ $json.uid }}.

Links

Discussion