MCP Gateway
ApiSessions

Touch session

Update last accessed timestamp and extend the session's expiration time (sliding window TTL). This is an API-only endpoint for programmatic access — no frontend UI currently consumes it.

POST
/api/v1/sessions/{session_id}/touch

Authorization

User API Key
AuthorizationBearer <token>

User API key (mgw_usr_live_* or mgw_usr_test_*)

In: header

Path Parameters

session_id*string
Formatuuid
access_token?|

Response Body

application/json

application/json

curl -X POST "https://loading/api/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/touch"
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "server_id": "820efca4-4a15-4ab7-82fc-9e76f6d61325",
  "bundle_id": "fc6f5a67-caa1-4339-9c14-a67826143b60",
  "process_state": {},
  "external_sessions": {
    "property1": "string",
    "property2": "string"
  },
  "last_accessed_at": "2019-08-24T14:15:22Z",
  "expires_at": "2019-08-24T14:15:22Z",
  "is_active": true,
  "is_expired": true,
  "is_idle": true,
  "created_at": "2019-08-24T14:15:22Z"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

List sessions

List MCP connection sessions with optional filtering by server or bundle ID. This is an API-only endpoint for programmatic access — no frontend UI currently consumes it.

Get notification settings

Get the current user's notification preferences. Creates default settings if none exist. This is an API-only endpoint for programmatic access — no frontend UI currently consumes it.