Deactivate a user
Tool: oppex.admin.deboardUser
Deactivates a person's account across your whole organization, in every workspace, for example when they leave the company. Their sessions end, including any assistant connections of their own. To remove someone from one workspace only, use Remove a user from a workspace.
What you provide
| Input | Required | Description |
|---|---|---|
| Person | Yes | The person to deactivate. The assistant finds them with List users. |
Example prompts
- "Lando Calrissian has left the company. Deactivate their account."
- "Offboard han.solo@rebellion.example.com."
- "Deactivate Sam Carter, and tell me first what they're still on call for."
The assistant confirms the person with you before it deactivates them.
Who can use it
| Your role | You can deactivate |
|---|---|
| Account Owner | Anyone except yourself |
| Account Admin | Anyone except an Account Owner and yourself |
| Any other role | No one |
Limits and errors
| Message | Meaning |
|---|---|
| Linked to an escalation policy | The person is still on one or more escalation policies. The message names them. |
| Linked to a schedule | The person is still on one or more schedules. The message names them. |
| Linked to unresolved incidents | Incidents are still assigned to the person. The message lists them. |
| "Global admin cannot delete owner" | You are an Account Admin and the person is an Account Owner. |
| "User not found for this client" | The person is not in your organization. |
| Acting on your own account | You cannot deactivate yourself. |
Oppex will not deactivate someone who could still be paged or who still owns open incidents. Take them off the named escalation policies and schedules, and reassign their incidents, then try again. Ask the assistant to run A person's on-call assignments to see what is left.