# List Workspace ONE user groups

Canonical URL: https://docs.fuse.init.inc/integrations/workspace-one-uem/actions/user_groups.list

List user groups via the Workspace ONE SCIM Groups API.

Action ID: `user_groups.list`
Provider: Workspace ONE UEM (`workspace_one_uem`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `ws1.user_groups.read`

## Input schema fields

- `page_size`
- `cursor`

## Output schema fields

- `user_groups`
- `user_groups[]`
- `user_groups[].id`
- `user_groups[].uuid`
- `user_groups[].name`
- `user_groups[].display_name`
- `user_groups[].group_type`
- `next_cursor`
- `total_count`

Provider overview: https://docs.fuse.init.inc/integrations/workspace-one-uem
Actions index: https://docs.fuse.init.inc/integrations/workspace-one-uem/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/workspace_one_uem/actions/user_groups.list
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/workspace_one_uem/actions