---
title: "Delete Mcp Gateway Sessions"
method: DELETE
path: "/v1/mcp/sessions"
tags: ["mcp"]
---

# Delete Mcp Gateway Sessions

`DELETE /v1/mcp/sessions`

Force-close live stateful MCP gateway sessions on this proxy worker, selected by session id prefix and/or by the LiteLLM user that opened them (proxy admin only).

## Query parameters

- `session_id_prefix` string, nullable
- `user_id` string, nullable

## Response `200`

Successful Response

- MCPGatewaySessionsTerminateResponse — Stateful sessions an administrator force-closed on this proxy worker.
  - `worker_pid` integer, required
  - `terminated_sessions` integer, required
  - `sessions` MCPGatewaySession[]
    - `session_id_prefix` string, required
    - `client_name` string, nullable
    - `client_version` string, nullable
    - `user_id` string, nullable
    - `user_email` string, nullable
    - `key_alias` string, nullable
    - `team_id` string, nullable
    - `team_alias` string, nullable
    - `client_ip` string, nullable
    - `idle_seconds` number, required
    - `in_flight_requests` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-10-05** `611a0ed75fe8` — 2 info
  - api tag `mcp` added
  - api tag `mcp_management` removed
- **2026-10-04** `51c2ca10dc0b` — 2 info
  - api tag `mcp_management` added
  - api tag `mcp` removed
- **2026-09-30** `85ac4287140e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/v1/mcp/sessions/delete.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/ee3a9ebe33fd?raw)