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

# Delete Sessions in Bulk

`POST /v1/sessions/bulk-stop`

## Request

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

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

## Request body

- SessionBulkStopPayload
  - `filters` SessionBulkStopFiltersPayload[], required: Filters used to match with sessions
    - `field` 'session_id' | 'deployment_tags' | 'request_id', 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 `200`

Success

- SessionBulkStopResponse
  - `processable` SessionStopResponse[], required: A list sessions that can be processed to be stopped
    - `session_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)