Skip to main content
Unban Member
Sets a banned member’s status back to "active", in this space and in the child spaces where they are banned (a ban covers child spaces, and so does lifting it). A request that was pending or rejected in a child space before the ban stays as it was. Unbanning makes the person an active member of this space even if they were never approved, for example when their request was still pending at the time of the ban. The member gets each space’s chat back the next time they open it. Requires the caller to be a moderator or admin. Moderators can only unban regular members, not other moderators or admins. Only the space creator (or a service or master key) can unban an admin, as only they can ban one.

Path Parameters

string
required
UUID of the space.
string
required
UUID of the membership record to unban.

Response

string
Confirmation message.
object
The updated membership record with status: "active".

Error Responses

The member is still banned in a parent of this space. Lift that ban first; bannedSpaceIds lists where.
A moderator unbanning someone who is a moderator or admin in this space or in one of the child spaces the unban covers.
Unbanning someone who is an admin in this space or in one of the child spaces the unban covers, by anyone but the space creator or a service or master key.
See also: useUnbanMember