List device groups
Returns a paginated list of all device groups in the enterprise. Device groups organize devices into logical collections by location, use case, or deployment stage, and serve as the primary unit for policy assignment, app deployment, and bulk commands.
Common Use Cases
Discovering group IDs for downstream operations; auditing group structure; populating group selectors in custom tools; confirming a group exists before assigning devices or Blueprints.
Best Practices
Use the name query parameter to filter instead of fetching all groups; cache group IDs for use in commands and policy calls; paginate with limit and offset for large enterprises.
Path parameters
A UUID string identifying enterprise.
Query parameters
Filter by group name
Number of results to return per page.
The initial index from which to return the results.
Response
successful operation