v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
esper_cloud_api_Device Group

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.

get/enterprise/{enterprise_id}/devicegroup/

Path parameters

enterprise_idstring required

A UUID string identifying enterprise.

Query parameters

namestring

Filter by group name

limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return the results.

Response

successful operation

countinteger required
nextstring url nullable
previousstring url nullable