List Members

List the active members of a conversation

GET /:projectId/api/v7/conversations/:conversationId/members

List Members

cURL

curl --request GET \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/conversations/:conversationId/members

200

{
  "data": [
    {}
  ],
  "pagination": {
    "page": 123,
    "pageSize": 123,
    "totalPages": 123,
    "totalItems": 123,
    "hasMore": true
  }
}

Returns a paginated list of active ConversationMember objects, each with the member’s user profile included. The caller must be a member (any status) to access this endpoint.

Path Parameters

conversationId · string · required

The ID of the conversation.

Query Parameters

page · number

Page number (1-based). Defaults to 1.

limit · number

Number of members per page. Defaults to 50. Maximum 100.

role · string

Filter by role. Accepted values: admin, member. If omitted, all roles are returned.

Space-scoped reputation

This endpoint has a space in context, so it accepts the opt-in reputation params. They add a spaceReputation field to each returned member’s user, alongside the always-present reputation total. Requires the reputation bundle. See the Reputation data model for the full contract.

spaceReputationId · string

Adds spaceReputation to each returned user. One of: a space <uuid> (that space’s bucket), none (the project-general bucket), or context (the space derived from this request’s context — per-row on lists). The empty string and the legacy general / null aliases are rejected (400). Missing buckets read as 0.

spaceReputationDescendants · boolean

Only honored with an explicit space <uuid>. When true, spaceReputation is the subtree sum — the space plus all of its descendants (the root space’s own bucket included). Ignored for none; not allowed with context.

Response

data · ConversationMember[]

Array of active membership records. Each includes a user field with id, name, username, avatar, and metadata.

pagination · object

Show properties

page · number

Current page number.

pageSize · number

Items per page.

totalPages · number

Total number of pages.

totalItems · number

Total number of active members.

hasMore · boolean

Whether more pages exist.

Error Responses

Forbidden — 403

{ "error": "You are not a member of this conversation.", "code": "chat/not-a-member" }