MEmetorial
Session Messages

List session messages

Returns a paginated list of messages for a session.

get/session-messages

Request

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

Query parameters

limitnumber
afterstring
beforestring
cursorstring
order'asc' | 'desc'
'unknown' | 'tool_call' | 'mcp_control' | 'mcp_message'
OR
string[]

Filter by message type(s)

'provider' | 'client'
OR
string[]

Filter by message source(s)

'child' | 'parent'
OR
string[]

Filter by message hierarchy

'waiting_for_response' | 'succeeded' | 'failed'
OR
string[]

Filter by message status(es)

string
OR
string[]

Filter by message ID(s)

string
OR
string[]

Filter by session ID(s)

string
OR
string[]

Filter by session provider ID(s)

string
OR
string[]

Filter by session connection ID(s)

string
OR
string[]

Filter by provider run ID(s)

string
OR
string[]

Filter by error ID(s)

string
OR
string[]

Filter by participant ID(s)

string
OR
string[]

Filter by parent message ID(s)

gtstring date-time

Only include records after this timestamp for session message creation time

ltstring date-time

Only include records before this timestamp for session message creation time

Filter session message creation time by date range

gtstring date-time

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

ltstring date-time

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

Filter session message 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": "smg_8hJkLmNpQrStUvWx",
      "session_id": "ses_4dEfGhJkLmNpQrSt",
      "session_provider_id": "spr_3cDeFgHjKlMnPqRs",
      "connection_id": "scn_2bCdEfGhJkLmNpQr",
      "provider_run_id": "prn_8hJkLmNpQrStUvWx",
      "hierarchy": {
        "type": "child"
      },
      "transport": {
        "mcp": {
          "transport": "unknown"
        }
      },
      "tool_call": {
        "id": "tcl_8hJkLmNpQrStUvWx",
        "tool_key": "create_issue",
        "session_id": "ses_4dEfGhJkLmNpQrSt",
        "message_id": "smg_3cDeFgHjKlMnPqRs",
        "session_provider_id": "spr_3cDeFgHjKlMnPqRs",
        "connection_id": "scn_2bCdEfGhJkLmNpQr",
        "provider_run_id": "prn_8hJkLmNpQrStUvWx",
        "sender_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"
        },
        "responder_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"
        },
        "tool": {
          "id": "pto_5jKlMnPqRsTuVwXy",
          "key": "create_issue",
          "name": "Create Issue",
          "description": "Creates a new issue in a GitHub repository",
          "specification_id": "psp_9gHjKlMnPqRsTuVw",
          "provider_id": "pro_5gHjKlMnPqRsTuVw",
          "created_at": "2025-09-15T10:30:00.000Z",
          "updated_at": "2026-01-10T14:45:00.000Z"
        },
        "error": {
          "id": "ser_6fGhJkLmNpQrStUv",
          "code": "CONNECTION_TIMEOUT",
          "message": "Connection timed out after 30 seconds",
          "session_id": "ses_4dEfGhJkLmNpQrSt",
          "provider_run_id": "prn_8hJkLmNpQrStUvWx",
          "connection_id": "scn_8hJkLmNpQrStUvWx",
          "group_id": "seg_7gHjKlMnPqRsTuVw",
          "similar_error_count": 5,
          "created_at": "2025-09-15T10:30:00.000Z"
        },
        "created_at": "2025-09-15T10:30:00.000Z"
      },
      "sender_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"
      },
      "responder_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"
      },
      "error": {
        "id": "ser_6fGhJkLmNpQrStUv",
        "code": "CONNECTION_TIMEOUT",
        "message": "Connection timed out after 30 seconds",
        "session_id": "ses_4dEfGhJkLmNpQrSt",
        "provider_run_id": "prn_8hJkLmNpQrStUvWx",
        "connection_id": "scn_8hJkLmNpQrStUvWx",
        "group_id": "seg_7gHjKlMnPqRsTuVw",
        "similar_error_count": 5,
        "created_at": "2025-09-15T10:30:00.000Z"
      },
      "created_at": "2025-09-15T10:30:00.000Z"
    }
  ]
}

Changes

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