MCP Gateway
ApiSessions

Delete session

Delete a session (soft delete by default). Use hard_delete=true for permanent removal. This is an API-only endpoint for programmatic access — no frontend UI currently consumes it.

DELETE
/api/v1/sessions/{session_id}

Authorization

User API Key
AuthorizationBearer <token>

User API key (mgw_usr_live_* or mgw_usr_test_*)

In: header

Path Parameters

session_id*string
Formatuuid

Query Parameters

hard_delete?boolean

Permanently delete (not recommended)

Defaultfalse
access_token?|

Response Body

application/json

curl -X DELETE "https://loading/api/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Create session

Create a new MCP connection session for a server or bundle. Requires either server_id or bundle_id (not both). This is an API-only endpoint for programmatic access — no frontend UI currently consumes it.

Get session

Get a session by ID. Sessions are scoped to users and cannot be accessed by other users. This is an API-only endpoint for programmatic access — no frontend UI currently consumes it.