---
title: "Delete a tool router session"
method: DELETE
path: "/api/v3.1/tool_router/session/{session_id}"
tags: ["Tool Router"]
---

# Delete a tool router session

`DELETE /api/v3.1/tool_router/session/{session_id}`

Deletes a tool router session. The session immediately stops being retrievable and executable — subsequent requests against it (including its MCP URL) return 404 — and any compute sandboxes attached to the session are shut down. The record is retained internally for audit purposes. Deleting an already-deleted session returns 404.

## Path parameters

- `session_id` string, toolRouterSessionId, required — The unique identifier of the tool router session

## Response `200`

Session successfully deleted.

- object
  - `session_id` string, toolRouterSessionId, required — The unique identifier of the deleted tool router session
  - `deleted` true, required — Always true — present to make the outcome explicit

## Other responses

- `400` — Bad request. This may occur if the session_id format is invalid, please pass this in trs_ prefix format
- `401` — Unauthorized. Authentication is required or the provided credentials are invalid.
- `404` — Not found. The session with the provided ID does not exist or has already been deleted.
- `500` — Internal server error.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/revisions/4239836857f8/schema)