Group management
Understand group management tool scopes, features, and capabilities, with sample workflows and example prompts.
Early Access release
- Tool name
okta_group_management- Okta scopes
okta.groups.readandokta.groups.manage
What you can do
- List all groups in your org with pagination
- Create new groups
- Retrieve group details including members and assigned apps
- Update group names and descriptions
- Add users to groups
- Remove users from groups
- View all apps that are assigned to a group
- Delete groups (requires confirmation)
- Paginate through large result sets using a cursor (max 200 items per page)
- Restrict actions based on your granted OAuth scopes
- Reduce processing costs with token-optimized responses
Sample use cases
| Use case | Prompt | Result |
|---|---|---|
| The admin is initiating a Finance-Engineering project and needs one shared group with a clear name and description with Alice added from the project team so membership is set up correctly from the start. | Create a group called 'FinEng Project' with the description 'Finance and Engineering project team', add Alice to it, then show me the group's members so I can confirm she was added. | The 'FinEng Project' group is created with its description, Alice is added, and the group's member list is shown so you can confirm she is in it. |
| The admin has collected a handful of groups over time and suspects some are empty and no longer needed. Before deleting anything, the admin wants to see each group's member count to spot empty groups and decide what to remove. | List my groups and show the member count for each, then flag any group that has zero members so I can decide whether to delete it. | Your groups are listed with each one's member count, and any empty group is flagged as a deletion candidate, with a note that built-in groups like Everyone and Okta Administrators can't be deleted. |