MEmetorial
Session Connections

Get session connection

Retrieves a specific connection from a session.

get/session-connections/{session_connection_id}

Request

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

Path parameters

session_connection_idstring required

Unique identifier of the session connection.

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

object'session.connection' required

String representing the object's type

idstring required

Unique session connection identifier

connection_state'connected' | 'disconnected' required

Connection state

transport'mcp' | 'tool_call' | 'metorial_protocol' | 'system' required

Transport protocol used

session_idstring required

Parent session ID

has_errorsboolean required

Whether the connection has any errors

has_warningsboolean required

Whether the connection has any warnings

created_atstring date-time required

Timestamp when created

last_message_atstring date-time required

Timestamp of last message

last_active_atstring date-time nullable required

Timestamp when last active

Example response

{
  "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.