Session Errors

Session errors track errors that occurred during a session. This read-only resource provides visibility into issues that happened during provider execution.

Session Errors object

Attributes

object

String

String representing the object's type

id

String

Unique session error identifier

code

String

Error code

message

String

Error message

data

Object

Error payload data

status

Enum

Indicates whether the error is still being processed or has been fully processed and grouped.

session_id

String

Parent session ID

provider_run_id

StringNullable

Provider run ID

connection_id

StringNullable

Connection ID

group_id

StringNullable

Error group ID

similar_error_count

Number

Count of similar errors in the group

created_at

Date

Timestamp when created

{
  "object": "session.error",
  "id": "ser_6fGhJkLmNpQrStUv",
  "code": "CONNECTION_TIMEOUT",
  "message": "Connection timed out after 30 seconds",
  "data": {
    "timeout_ms": 30000
  },
  "status": "processing",
  "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"
}

List all session errors

Returns a paginated list of errors across all sessions.

Query Parameters

limit

NumberOptional

Maximum number of items to return (1-100)

after

StringOptional

Return items after this ID

before

StringOptional

Return items before this ID

cursor

StringOptional

Pagination cursor from a previous response

order

EnumOptional

Sort order for results

type

UnionOptional

Filter by error type(s)

id

UnionOptional

Filter by session error ID(s)

session_id

UnionOptional

Filter by session ID(s)

session_provider_id

UnionOptional

Filter by session provider ID(s)

session_connection_id

UnionOptional

Filter by session connection ID(s)

session_error_group_id

UnionOptional

Filter by error group ID(s)

provider_run_id

UnionOptional

Filter by provider run ID(s)

provider_id

UnionOptional

Filter by provider ID(s)

session_message_id

UnionOptional

Filter by session message ID(s)

GEThttp://api.metorial.com/session-errors
curl -X GET "https://api.metorial.com/session-errors" \
  -H "Authorization: Bearer metorial_sk_..."

List session errors

Returns a paginated list of errors that occurred in a session.

URL Parameters

session_id

String

The unique identifier for the session

Query Parameters

limit

NumberOptional

Maximum number of items to return (1-100)

after

StringOptional

Return items after this ID

before

StringOptional

Return items before this ID

cursor

StringOptional

Pagination cursor from a previous response

order

EnumOptional

Sort order for results

type

UnionOptional

Filter by error type(s)

id

UnionOptional

Filter by session error ID(s)

session_id

UnionOptional

Filter by session ID(s)

session_provider_id

UnionOptional

Filter by session provider ID(s)

session_connection_id

UnionOptional

Filter by session connection ID(s)

session_error_group_id

UnionOptional

Filter by error group ID(s)

provider_run_id

UnionOptional

Filter by provider run ID(s)

provider_id

UnionOptional

Filter by provider ID(s)

session_message_id

UnionOptional

Filter by session message ID(s)

GEThttp://api.metorial.com/sessions/:session_id/errors
curl -X GET "https://api.metorial.com/sessions/ses_Rm4Mnheq2bfEPhBhP7SY/errors" \
  -H "Authorization: Bearer metorial_sk_..."

Get session error

Retrieves a specific error that occurred in a session.

URL Parameters

session_id

String

The unique identifier for the session

session_error_id

String

The unique identifier for the session_error

GEThttp://api.metorial.com/sessions/:session_id/errors/:session_error_id
curl -X GET "https://api.metorial.com/sessions/ses_Rm4Mnheq2bfEPhBhP7SY/errors/ses_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."