Skip to content

Delete Device Group from a Target List
Stable

Request

Removes a Device Group from a Pipeline Target List.

Detaches the specified Device Group from the Target List; the Device Group itself and its devices are unaffected, only its inclusion in this pipeline's scope. This does not stop any pipeline actions that are currently running.

About Target List Device Groups Target Lists can scope a pipeline stage to individual device Targets, whole Device Groups, or both. Removing a Device Group narrows the pipeline's scope without deleting the group or its devices.

Key Fields / Query Parameters

  • pipeline_id — UUID of the parent Pipeline
  • targetlist_id — UUID of the Target List
  • devicegroup_id — UUID of the Device Group to remove from the Target List
Security
pipelines_SCAPIAuthToken
Path
pipeline_idstring, (uuid)required

ID of the Pipeline

targetlist_idstring, (uuid)required

ID of the Target List

devicegroup_idstring, (uuid)required

ID of the Device Group

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

Responses

Deleted Device Group from Target List

Bodyapplication/json
codeinteger
messagestring
contentArray of strings, (uuid)
Response
{
  "code": 0,
  "message": "string",
  "content": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ]
}