Docmost Octri Preview
POST/groups/members/remove

Remove a user from a group

Removes a user from a workspace group. Supply groupId and userId to identify the group-member association. You need Manage/Group workspace permission to remove a member.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 body fields

The group and user IDs for the membership to remove.

groupIdstringrequired
ID of the group to remove the user from.
userIdstringrequired
ID of the user to remove.

3 status codes
200Returns a success response confirming that the group member was removed.
dataunknownoptional
Response payload
statusintegeroptional
successbooleanoptional
400Returned when the group member is not found or the request fails validation.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
403Returned when the authenticated user lacks Manage/Group workspace permission.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

A 400 is returned when the specified group member is not found or the request fails validation. A 403 is returned when the authenticated user lacks Manage/Group workspace permission. groupId and userId must be UUIDs.