Session Participants

Session participants represent the clients and other entities that are connected to a session. This read-only resource tracks who is participating in a session.

Session Participants object

Attributes

object

String

String representing the object's type

id

String

Unique session participant identifier

type

StringNullable

Participant type

name

StringNullable

Display name

description

StringNullable

Description

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.participant",
  "id": "spt_5eFgHjKlMnPqRsTu",
  "type": "client",
  "name": "Claude Desktop",
  "description": "Claude desktop client connection",
  "metadata": {
    "client_version": "1.2.3"
  },
  "session_id": "ses_4dEfGhJkLmNpQrSt",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List session participants

Returns a paginated list of participants 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 participant type

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

Get session participant

Retrieves a specific participant in a session.

URL Parameters

session_id

String

The unique identifier for the session

session_participant_id

String

The unique identifier for the session_participant

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