List users
Tool: oppex.admin.listUsers
Lists the active people in your connection's workspace with their role there, or finds people by name or email. The assistant uses it to find the person you mean before it adds, removes or deactivates them.
What you provide
| Input | Required | Description |
|---|---|---|
| Search | No | Part of a name or email. Matching ignores capitals and finds the text anywhere in the name or email. Leave it out to list everyone. |
| Page number | No | Which page of results to return. Starts at 1. |
| Page size | No | How many people per page. The default is 20 and the maximum is 100. |
Example prompts
- "Who is in this workspace?"
- "List the Workspace Admins here."
- "Find everyone with an @rebellion.example.com email."
- "Is Han Solo a member of this workspace, and what's their role?"
Who can use it
Anyone, whatever their role.
What you get back
For each person: their name, email and role in the workspace. The response also gives the total number of matching people, so the assistant can fetch the next page.