---
title: "Delete a Deployment"
method: DELETE
path: "/v13/deployments/{id}"
tags: ["deployments"]
---

# Delete a Deployment

`DELETE /v13/deployments/{id}`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v13/deployments/{id}`
- Auth: HTTP bearer

This API allows you to delete a deployment, either by supplying its `id` in the URL or the `url` of the deployment as a query parameter. You can obtain the ID, for example, by listing all deployments.

## Path parameters

- `id` string, required: The ID of the deployment to be deleted

## Query parameters

- `url` string: A Deployment or Alias URL. In case it is passed, the ID will be ignored
- `teamId` string
- `slug` string

## Response `200`

The deployment was successfully deleted

- object
  - `state` 'DELETED', required: A constant with the final state of the deployment.
  - `uid` string, required: The removed deployment ID.

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`: The deployment was not found
- `409`
- `410`

## Changes

- **2026-10-15** `8939e3983223`: 1 info
  - added the non-success response with the status `409`
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2025-03-19** `37b482c58c92`: 2 info
  - added the new optional `query` request parameter `slug`
  - added the non-success response with the status `401`

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v13/deployments/:id/delete.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)