Terminate an MCP Streamable HTTP session

DELETE 
/v1/mcp

Legacy-era only (2025-11-25 and earlier). Terminate the MCP session identified by the Mcp-Session-Id header. 2026-07-28 requests are sessionless and do not use DELETE. Subsequent legacy requests bearing the same session id will receive 404 Not Found.

Request

Responses

204

Session terminated.

401

Unauthorized. The /v1/mcp endpoint requires runtime.auth to be configured. Configure an API key provider in your Spicepod and retry with credentials.

403

Forbidden. The Host header value is not in the runtime.mcp.allowed_hosts list, or the Origin header is not in runtime.cors.allowed_origins. Host ["*"] disables the Host check. Origin ["*"] expands to localhost defaults — it does not accept every Origin.

404

Unknown or already-terminated Mcp-Session-Id.