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

Enum

Participant type

identifier

String

Participant identifier

name

String

Display name

data

Object

Participant payload data

provider_id

StringNullable

Provider ID if associated

created_at

Date

Timestamp when created

{
  "object": "session.participant",
  "id": "spt_5eFgHjKlMnPqRsTu",
  "type": "unknown",
  "identifier": "claude-desktop",
  "name": "Claude Desktop",
  "data": {
    "identifier": "claude-desktop",
    "name": "Claude Desktop"
  },
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z"
}

List session participants

Returns a paginated list of participants in a session.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

type

UnionOptional

Filter by participant type(s)

id

UnionOptional

Filter by participant ID(s)

session_id

UnionOptional

Filter by session ID(s)

session_connection_id

UnionOptional

Filter by session connection ID(s)

session_message_id

UnionOptional

Filter by session message ID(s)

created_at

ObjectOptional

Filter session participant creation time by date range

updated_at

ObjectOptional

Filter session participant last update time by date range

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

Get session participant

Retrieves a specific participant in a session.

URL Parameters

session_participant_id

String

The unique identifier for the session_participant

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