Session Errors

List all session errors

Returns a paginated list of errors across all sessions.

get/session-errors

Request

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

Query parameters

limitnumber
afterstring
beforestring
cursorstring
order'asc' | 'desc'
'message_processing_timeout' | 'message_processing_provider_error' | 'message_processing_system_error'
OR
string[]

Filter by error type(s)

string
OR
string[]

Filter by session error 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 error group ID(s)

string
OR
string[]

Filter by provider run ID(s)

string
OR
string[]

Filter by provider ID(s)

string
OR
string[]

Filter by session message ID(s)

gtstring date-time

Only include records after this timestamp for session error creation time

ltstring date-time

Only include records before this timestamp for session error creation time

Filter session error creation time by date range

gtstring date-time

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

ltstring date-time

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

Filter session error last update time by date range

searchstring
Example:github

Search by session error ID or error code, or by the name of a related provider, deployment, or auth config

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": "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"
    }
  ]
}

Changes

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