Skip to content

Delete a Target or Device from a Target List
Stable

Request

Removes a Target from a Pipeline Target List.

Permanently deletes the specified device-level Target record from the Target List; the device itself is unaffected, only its inclusion in this pipeline's scope.

About Targets A Target represents a single device entry within a Target List. Deleting it removes that device from the pipeline's scope for future runs — it does not affect any pipeline runs that have already started.

Key Fields / Query Parameters

  • pipeline_id — UUID of the parent Pipeline
  • targetlist_id — UUID of the Target List
  • target_id — UUID of the Target to delete
Security
pipelines_SCAPIAuthToken
Path
pipeline_idstring, (uuid)required

ID of the Pipeline

targetlist_idstring, (uuid)required

ID of the Target List

target_idstring, (uuid)required

ID of the Target

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

Responses

Deleted Target from Target List

Bodyapplication/json
codeinteger
messagestring
contentobject(pipelines_Target)
Response
{
  "code": 0,
  "message": "string",
  "content": {
    "id": "string",
    "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0",
    "device_id": "3bafab7b-4400-4bcf-8e6e-09f954699940",
    "device_name": "string",
    "device_alias": "string",
    "is_active": true,
    "created_by": 0,
    "updated_by": 0,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}