Session Error Groups

Session error groups aggregate similar errors that occurred during a session. This read-only resource helps identify patterns in errors.

Session Error Groups object

Attributes

object

String

String representing the object's type

id

String

Unique session error group identifier

code

String

Error code

message

String

Error message

data

Object

Error group data from first occurrence

provider_id

StringNullable

Provider ID

occurrence_count

Number

Number of errors in this group

created_at

Date

Timestamp when created

{
  "object": "session.error_group",
  "id": "seg_7gHjKlMnPqRsTuVw",
  "code": "CONNECTION_TIMEOUT",
  "message": "Connection timed out",
  "data": {
    "timeout_ms": 30000
  },
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "occurrence_count": 5,
  "created_at": "2025-09-15T10:30:00.000Z"
}

List all session error groups

Returns a paginated list of error groups 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 error group ID(s)

session_id

UnionOptional

Filter by session ID(s)

provider_id

UnionOptional

Filter by provider ID(s)

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

Get session error group

Retrieves a specific error group by ID across all sessions.

URL Parameters

session_error_group_id

String

The unique identifier for the session_error_group

GEThttp://api.metorial.com/session-error-groups/:session_error_group_id
curl -X GET "https://api.metorial.com/session-error-groups/ses_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

List session error groups

Returns a paginated list of error groups for 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 error group ID(s)

session_id

UnionOptional

Filter by session ID(s)

provider_id

UnionOptional

Filter by provider ID(s)

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

Get session error group

Retrieves a specific error group for a session.

URL Parameters

session_id

String

The unique identifier for the session

session_error_group_id

String

The unique identifier for the session_error_group

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