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

String

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": {
    "client_version": "1.2.3"
  },
  "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

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 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)

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