Removes up to 100 users from a structure. Only direct memberships are removed — a user who inherits membership from an ancestor structure keeps that inherited membership. This endpoint supports partial success: a user who could not be removed is reported in errors with a status code and a reason, and a response with a populated errors array is still a 200. A rule-based membership is reported this way rather than removed, because only a change to the rule can remove it.
Use this endpoint to remove one or more users from a structure. Send up to 100 user IDs per request. Removing a user from a structure does not deactivate them or remove them from your organization. They keep their membership of every other structure.
Requirements
Only direct memberships are removed. A user who also reaches this structure through an inherited membership from an ancestor keeps that inherited membership, and so may still appear against the structure after this call. To remove their access entirely, remove them from the ancestor that grants it.
Removing a user who is not a member of the structure is not an error.