Ctrl+K

Bulk remove users from organization

delete/api/usermanagement/v1/organizations/{orgId}/users

Removes multiple users from an organization in a single operation. This may require approval based on organization policy configuration, such as when policies require approval for user removal operations. Supports authentication via OTP (including WebAuthn challenges).

Approval/rejection applies to all removals atomically. All validation errors are collected and returned in structured format.

Path Parameters

orgIdstringRequired
The unique identifier of the organization from which users will be removed

Request Body

externalUserIds array[string] required

List of external user IDs to remove from the organization

Min items: >= 1 items

force boolean

Force removal even if users have critical resource access

Default: false

otp string required

One-time password for authentication

Min length: >= 1 characters

200 Response

202 Response

400 Response

name string

Example: ValidationFailed

error string

Example: Cannot remove 2 user(s) due to validation failures

status integer

Example: 400

failedValidations dictionary<string, array>

Example:

{"user123":["Cannot remove user user123, resources would be left orphaned: 'Wallet A', 'Wallet B'"],"user456":["A user cannot remove themselves from an organization"]}