Skip to content

Delete stage operation list
Stable

Request

Permanently deletes an Operation List attached to a Pipeline Stage.

Removes the Operation List record identified by operationlist_id from the given stage_id, along with the individual Operations it contains. This does not delete the Stage itself, only the Operation List and its operations.

About Delete Stage Operation List

⚠️ Android only. Pipelines orchestrate multi-step device operations using a Pipeline → Stages → Operation List → Target List hierarchy. An Operation List holds the ordered set of actions (such as commands or scripts) that a Stage runs against its Target List. Deleting the Operation List removes that stage's action definitions, so the stage will have nothing to execute until a new Operation List is created and attached.

Common Use Cases

Removing an outdated Operation List before rebuilding a Pipeline Stage with new actions

Cleaning up unused Operation Lists during Pipeline maintenance

Best Practices

Confirm the Operation List is not currently referenced by an active or scheduled Pipeline Run before deleting it

Create the replacement Operation List first if the Stage needs to remain runnable without downtime

Workflow

Call GET /pipelines/v0/pipelines/{pipeline_id}/stages/{stage_id}/ to confirm the operationlist_id belongs to the intended stage

DELETE the Operation List using its stage_id and operationlist_id

Create and attach a new Operation List to the stage if it should continue to run actions

Security
pipelines_SCAPIAuthToken
Path
stage_idstringrequired

ID of the Stage

operationlist_idstringrequired

ID of the Operation List

cURL
curl -i -X DELETE \
  'https://api.esper.io/_mock/openapi/pipelines/v0/stages/{stage_id}/operationlists/{operationlist_id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Delete operation list from stage

Bodyapplication/json
codeinteger
messagestring
contentobject(pipelines_OperationList)
Response
{
  "code": 0,
  "message": "string",
  "content": {
    "id": "string",
    "pipeline_id": "string",
    "stage_id": "string",
    "name": "string",
    "description": "string",
    "created_by": 0,
    "updated_by": 0,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}