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

type

StringNullable

Error type

name

StringNullable

Error name

message

StringNullable

Error message

count

Number

Number of errors in this group

metadata

ObjectNullable

Custom key-value pairs

session_id

String

Parent session ID

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
"object": "session.error_group",
"id": "seg_7gHjKlMnPqRsTuVw",
"type": "RuntimeError",
"name": "ConnectionTimeout",
"message": "Connection timed out",
"count": 5,
"metadata": {
"first_seen": "2025-09-15"
},
"session_id": "ses_4dEfGhJkLmNpQrSt",
"created_at": "2025-09-15T10:30:00.000Z",
"updated_at": "2026-01-10T14:45: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

StringOptional

Filter by error type

session_id

UnionOptional

Filter by session 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

StringOptional

Filter by error type

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_..."