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

type

StringNullable

Error type

name

StringNullable

Error name

message

StringNullable

Error message

stack

StringNullable

Error stack trace

metadata

ObjectNullable

Custom key-value pairs

session_id

String

Parent session ID

session_error_group_id

StringNullable

Error group ID

provider_run_id

StringNullable

Provider run ID

created_at

Date

Timestamp when created

{
  "object": "session.error",
  "id": "ser_6fGhJkLmNpQrStUv",
  "type": "RuntimeError",
  "name": "ConnectionTimeout",
  "message": "Connection timed out after 30 seconds",
  "stack": "Error: Connection timed out\n    at Socket.connect...",
  "metadata": {
    "timeout_ms": 30000
  },
  "session_id": "ses_4dEfGhJkLmNpQrSt",
  "session_error_group_id": "seg_7gHjKlMnPqRsTuVw",
  "provider_run_id": "prn_8hJkLmNpQrStUvWx",
  "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

StringOptional

Filter by error type

session_id

UnionOptional

Filter by session ID(s)

session_error_group_id

UnionOptional

Filter by error group ID(s)

provider_run_id

UnionOptional

Filter by provider run 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

StringOptional

Filter by error type

session_error_group_id

UnionOptional

Filter by error group ID(s)

provider_run_id

UnionOptional

Filter by provider run 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_..."