---
title: "Delete Deployments in Bulk"
method: POST
path: "/v1/deployments/bulk-stop"
tags: ["Deployments"]
---

# Delete Deployments in Bulk

`POST /v1/deployments/bulk-stop`

## Request

- Base URL: `https://api.edgegap.com`
- URL: `https://api.edgegap.com/v1/deployments/bulk-stop`
- Auth: API key in header `authorization`

Make a bulk delete of deployments using filters. All the deployments matching the given filters will be permanently deleted.

## Request body

- DeploymentBulkStopPayload
  - `filters` DeploymentBulkStopFiltersPayload[], required: Filters used to match with deployments
    - `field` 'request_id' | 'deployment_tags', required: The field on which to apply the filter
    - `values` string[], required: Values that will be used for the filter
    - `filter_type` 'any' | 'all' | 'not', required: Types of filter used. Possible values are: ['any', 'all', 'not']

## Response `202`

Accepted

- DeploymentBulkStopResponse
  - `processable` DeploymentStopResponse[], required: A list deployments that can be processed to be stopped
    - `request_id` string, required: The id of the request for a deployment

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/edgegap/apis/edgegap-v1.md) · [All operations](https://skmtc.dev/edgegap/apis/edgegap-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/edgegap/apis/edgegap-v1/revisions/9fa2b393a6be?raw)