Remove a user from a workspace
Tool: oppex.admin.removeUser
Removes a person from one workspace. Their account and their access to other workspaces stay as they are. To remove someone from the whole organization, use Deactivate a user instead.
What you provide
| Input | Required | Description |
|---|---|---|
| Workspace | Yes | The workspace to remove the person from. |
| Person | Yes | The person to remove. |
Example prompts
- "Remove Han Solo from the Rebel Alliance workspace."
- "Jordan Lee moved teams — take them out of the Staging workspace but keep their other access."
- "Remove every contractor from this workspace."
For a group of people, the assistant lists them first and removes each one after you confirm.
Who can use it
A Workspace Admin or higher in that workspace.
Limits and errors
| Message | Meaning |
|---|---|
| "User cannot be removed (org-level admin or not a member)" | The person is an Account Owner or Account Admin, who belong to every workspace, or they are not a member of this workspace. |
| On-call or incident links | The person is still on an escalation policy or schedule in this workspace, or has unresolved incidents assigned there. The message names each one. |
| Acting on your own account | You cannot remove yourself. |
Take the person off rotations first
Oppex will not remove someone who could still be paged in the workspace. Take them off the named escalation policies and schedules, and reassign their open incidents, then try again.