Skip to main content

Delete Human Task

Endpoint: DELETE /api/human/tasks/delete/{taskId}

Deletes a Human task execution. Use this endpoint only to delete a task that has been disconnected from a workflow execution due to error conditions. Under normal conditions, there is no need to use this endpoint.

The invoking user should be one of the following:

  • Cluster admin
  • Task owner of the Human task
  • User with DELETE permission for the Human task definition
warning

If this API is used for a Human task that is still associated with a workflow execution, the workflow will not be able to proceed normally and must be retried or restarted to generate a new Human task.

Path parameters

ParameterDescriptionTypeRequired/ Optional
taskIdThe task ID of the Human task execution to be deleted.stringRequired.

Response

Returns 200 OK, indicating that the Human task execution has been deleted. Returns 400 if an invalid task execution ID is provided.

Examples

Delete a Human task execution

Request

curl -X 'DELETE' \
'https://<YOUR-CLUSTER>/api/human/tasks/delete/64d2b342-0268-11f1-8b8d-6219b54da7fe' \
-H 'accept: */*' \
-H 'X-Authorization: <TOKEN>'

Response

Returns 200 OK, indicating that the Human task execution has been deleted.