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
| Name | Type | Default | Description |
|---|---|---|---|
user_id Required | string | - | 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
| Field | Type | Description |
|---|---|---|
userId | string | UUID of the removed user. |
removedAt | string | When the removal was performed. |
removedMembershipsCount | number | Number of org memberships hard-deleted for this user. |