Skip to main content
List Space Members
Returns a paginated list of space members with embedded user details.

Path Parameters

string
required
UUID of the space.

Query Parameters

string
Service key only: the user to list as. The page is exactly what that user’s own access token would get (their membership, so a members-only space’s list is open to them only as an active member). Leave it out for the anonymous view: a members-only space’s list returns 403. A user token always acts as its own user and must not send it, and neither may a request with no credentials (400 space/acting-user-not-allowed).
number
Page number. Defaults to 1.
number
Results per page.
string
Filter by status: "pending", "active", "banned", or "rejected".
string
Filter by role: "admin", "moderator", or "member".

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.

Response

SpaceMemberWithUser[]
Array of SpaceMemberWithUser objects.
object
Standard pagination metadata.

Error Responses

Returned when spaceId isn’t a valid UUID. Checked before sign-in, permissions and the endpoint’s other checks.
The space has readingPermission: "members" and the caller is not an active member (no membership, or one that is pending, banned or rejected).
A user token, or a request with no credentials, sent actingUserId, even naming its own user. Only a service key names the user it acts as; a user token always acts as its own user.
Returned when a service key names an actingUserId that isn’t a user in this project.
The space doesn’t exist, or the viewer can’t see it (a private space they aren’t an active member of, or a space under one). Both answer the same way, before any permission check. See Space visibility.
See also: useFetchSpaceMembers