Delete a workflow

This is an experimental feature and is not recommended for use in a production environment. For updates on the progress of the feature or if you want to leave feedback, see the associated GitHub issue.

When you no longer need a workflow template, you can delete it by calling the Delete Workflow API.

Note that deleting a workflow only deletes the stored template but does not deprovision its resources.

Path and HTTP methods

  1. DELETE /_plugins/_flow_framework/workflow/<workflow_id>

Path parameters

The following table lists the available path parameters.

ParameterData typeDescription
workflow_idStringThe ID of the workflow to be retrieved. Required.

Example request

  1. DELETE /_plugins/_flow_framework/workflow/8xL8bowB8y25Tqfenm50

copy

Example response

If the workflow exists, a delete response contains the status of the deletion, where the result field is set to deleted on success or not_found if the workflow does not exist (it may have already been deleted):

  1. {
  2.   "_index": ".plugins-flow_framework-templates",
  3.   "_id": "8xL8bowB8y25Tqfenm50",
  4.   "_version": 2,
  5.   "result": "deleted",
  6.   "_shards": {
  7.     "total": 1,
  8.     "successful": 1,
  9.     "failed": 0
  10.   },
  11.   "_seq_no": 2,
  12.   "_primary_term": 1
  13. }