Remove users from organization

Remove multiple users from the organization in a single request.

• You cannot remove yourself
• Removed users lose access to all organization resources
• This action cannot be undone

DELETE /admin/users

cURL

single

curl --request DELETE \
  --url https://www.asteragents.com/api/admin/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userIds": [
    "user_2ABC123DEF"
  ]
}
'

200

{
  "success": true,
  "total": 2,
  "successful": 2,
  "failed": 0,
  "results": [
    {
      "userId": "user_2ABC123DEF",
      "success": true
    },
    {
      "userId": "user_2XYZ789GHI",
      "success": true
    }
  ]
}

Authorizations

Authorization · string · header · required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Body

application/json

userIds · string[] · required

Array of Clerk user IDs to remove

Required array length: 1 - 50 elements

Response

200

application/json

All users removed successfully

success · boolean · required

total · integer · required

successful · integer · required

failed · integer · required

results · object[] · required

errors · object[]