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

# Delete a Deployment

`DELETE /v13/deployments/{id}`

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
  - `uid` string, required — The removed deployment ID.
  - `state` 'DELETED', required — A constant with the final state of the deployment.

## 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
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)