Skip to main content

Remove User (Admin)

Remove a user from the calling org. Hard-deletes all memberships and revokes API keys + OAuth tokens for that user × org. Cannot remove yourself or the last admin. Requires an admin-scoped API key.

Parameters

NameTypeDefaultDescription
user_id Requiredstring-UUID of the user to remove from the org.

Use Cases

  • Offboard a departing employee — revoke all their API keys and OAuth tokens for this org
  • Immediately cut access for a compromised account

Example Usage

Remove a user by ID

{
"tool": "admin_remove_user",
"arguments": {
"user_id": "3f7c2b1a-9d4e-4c2a-8b1f-0a1b2c3d4e5f"
}
}

Response Format

FieldTypeDescription
userIdstringUUID of the removed user.
removedAtstringWhen the removal was performed.
removedMembershipsCountnumberNumber of org memberships hard-deleted for this user.