A SpaceMember record represents a user’s membership in a specific space. It tracks their role (admin, moderator, or member), membership status (pending, active, banned, or rejected), and join timestamp.
Properties
| Property | Type | Description |
|---|
id | string | Unique membership record identifier (UUID). |
projectId | string | The project this membership belongs to. |
spaceId | string | ID of the space this membership is for. |
userId | string | ID of the user who is a member. |
role | "admin" | "moderator" | "member" | The user’s role in the space. |
status | "pending" | "active" | "banned" | "rejected" | The user’s membership status. |
joinedAt | Date | Timestamp when the membership was created. |
createdAt | Date | Record creation timestamp. |
Membership Statuses
| Status | Description |
|---|
pending | Join request submitted but awaiting moderator/admin approval. Only applies when the space has requireJoinApproval: true. |
active | Full membership granted — user can read and post according to space permissions. |
banned | User has been banned from the space. Banned users cannot access or post. |
rejected | Join request was declined by a moderator or admin. |
Roles
| Role | Description |
|---|
admin | Full control: can update/delete the space, manage all members and roles, create rules, and moderate all content. |
moderator | Can approve/decline/ban members, moderate content and reports, but cannot change space settings or manage admin accounts. |
member | Regular participant. Can read and post according to the space’s postingPermission setting. |
SpaceMemberWithUser
Returned by the list members and list team endpoints. Includes embedded public user details.
| Property | Type | Description |
|---|
membershipId | string | The membership record ID. |
role | "admin" | "moderator" | "member" | Member’s role. |
status | "pending" | "active" | "banned" | "rejected" | Member’s status. |
joinedAt | Date | When the user joined. |
user.id | string | User UUID. |
user.username | string | Username. |
user.displayName | string | Display name. |
user.avatar | string | Avatar URL. |
user.metadata | object | Public metadata. |
Sensitive user fields (email, password hash, secureMetadata) are excluded from SpaceMemberWithUser responses.
