Skip to content

Get all Devices in the device group
Stable

Request

Retrieves all devices in a Device Group attached to a Pipeline Target List.

Returns the devices that belong to the specified Device Group, as scoped through this Target List — this is the set of devices that pipeline stages using the Target List will act on via this group.

About Target List Device Groups Target Lists can scope a pipeline stage to whole Device Groups. This endpoint resolves a Device Group attachment down to its actual member devices, which is useful for confirming exactly who will be affected before a pipeline run.

Key Fields / Query Parameters

  • pipeline_id — UUID of the parent Pipeline
  • targetlist_id — UUID of the Target List
  • device_group_id — UUID of the Device Group whose member devices you want to list
Security
pipelines_SCAPIAuthToken
Path
pipeline_idstring, (uuid)required

ID of the Pipeline

targetlist_idstring, (uuid)required

ID of the Target List

device_group_idstring, (uuid)required

ID of the Device Group

cURL
curl -i -X GET \
  'https://develop-api.esper.io/_mock/openapi/pipelines/v0/pipelines/{pipeline_id}/targetlists/{targetlist_id}/devicegroups/{device_group_id}/devices/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

All Devices in Device group

Bodyapplication/json
codeinteger
messagestring
contentobject
Response
{
  "code": 0,
  "message": "string",
  "content": {
    "count": 0,
    "previous": "string",
    "next": "string",
    "results": [ … ]
  }
}