Skip to content

Delete stage operation list
Stable

Request

⚠️ Android only. Pipelines run on Android devices only.

Removes an Operation List from a Pipeline stage.

Deletes the specified Operation List from the stage and returns the deleted record. The stage no longer runs the Operations in that list during future pipeline runs.

About Deleting Operation Lists An Operation List defines what a Stage does. Removing it changes the stage's behavior for every future run of the pipeline, so review the list's Operations before deleting it.

Key Fields / Query Parameters

  • stage_id — UUID of the Stage (path parameter)
  • operationlist_id — UUID of the Operation List to delete (path parameter)

Common Use Cases

  • Removing an obsolete set of actions from a stage
  • Cleaning up a stage before rebuilding its Operation List

Best Practices

  • Check the list's Operations with GET /pipelines/v0/operationlists/{operationlist_id}/operations/ before deleting
  • Avoid deleting an Operation List while a run of its pipeline is in progress

Workflow

  1. Call GET /pipelines/v0/stages/{stage_id}/operationlists/ to confirm the target
  2. Review its Operations
  3. Call this endpoint
Security
pipelines_SCAPIAuthToken
Path
stage_idstringrequired

ID of the Stage

operationlist_idstringrequired

ID of the Operation List

cURL
curl -i -X DELETE \
  'https://develop-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"
  }
}