/users/{userId}Remove member
Removes a member from the active workspace roster. The user row is retained for historical actor references, active application sessions are revoked, and the member no longer appears in the workspace user roster.
Authorization
Scheme
- bearerAuth
Required scopes
- user:disable
Allowed roles
- owner
- admin
Remove a member from the workspace.
Parameters
- Name
userId- Type
- path string
- Description
- Required parameter.
Responses
- 204
Member removed
- 400
Invalid request. Codes: - `auth_member_self_removal_forbidden` — caller targeted themselves
- application/json ProblemDetails
- 403
Caller lacks authority for this member removal. Codes: - `auth_authz_member_remove_denied` — matrix rejects the remove action - `auth_member_removal_forbidden` — caller cannot remove an Owner target
- application/json ProblemDetails
- 404
Target user not found in the caller's tenant. Code: - `auth_user_not_found`
- application/json ProblemDetails
- 409
Tenant invariant would be violated. Code: - `auth_user_last_owner_required` — removal would leave zero active Owners
- application/json ProblemDetails
- default
Error
- application/json ProblemDetails