MEmetorial
Session Connections

List session connections

Returns a paginated list of connections for a session.

get/session-connections

Request

  • Base URL
    https://api.metorial.com
  • Auth
    HTTP bearer

Query parameters

limitnumber
afterstring
beforestring
cursorstring
order'asc' | 'desc'
'active' | 'archived'
OR
string[]

Filter by connection status

'connected' | 'disconnected'
OR
string[]

Filter by connection state

string
OR
string[]

Filter by session connection ID(s)

string
OR
string[]

Filter by connected agent ID(s)

string
OR
string[]

Filter by connected identity actor ID(s)

string
OR
string[]

Filter by the selected consumer profile ID or IDs.

string
OR
string[]

Filter by connected consumer ID(s)

string
OR
string[]

Filter by connected identity ID(s)

string
OR
string[]

Filter by connected agent instance ID(s)

string
OR
string[]

Filter by session ID(s)

string
OR
string[]

Filter by session provider ID(s)

string
OR
string[]

Filter by participant ID(s)

gtstring date-time

Only include records after this timestamp for session connection creation time

ltstring date-time

Only include records before this timestamp for session connection creation time

Filter session connection creation time by date range

gtstring date-time

Only include records after this timestamp for session connection last update time

ltstring date-time

Only include records before this timestamp for session connection last update time

Filter session connection last update time by date range

Headers

Metorial-Versionstring
Example:2025-01-01

Pin the dated API version for this request, e.g. 2025-01-01. Defaults to the version configured for the environment.

Response

Successful response

Example response

{
  "items": [
    {
      "id": "scn_8hJkLmNpQrStUvWx",
      "mcp": {
        "protocol_version": "2024-11-05"
      },
      "session_id": "ses_4dEfGhJkLmNpQrSt",
      "participant": {
        "id": "spt_5eFgHjKlMnPqRsTu",
        "identifier": "claude-desktop",
        "name": "Claude Desktop",
        "data": {
          "identifier": "claude-desktop",
          "name": "Claude Desktop"
        },
        "provider_id": "pro_5gHjKlMnPqRsTuVw",
        "created_at": "2025-09-15T10:30:00.000Z"
      },
      "created_at": "2025-09-15T10:30:00.000Z",
      "last_message_at": "2025-09-15T10:30:00.000Z",
      "last_active_at": "2025-09-15T10:30:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.