Skip to main content
GET
/
:projectId
/
api
/
v7
/
conversations
/
:conversationId
/
members
List Members
curl --request GET \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/conversations/:conversationId/members
{
  "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

​
Error Responses

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