Try it free

Permanently delete a trashed workflow

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Permanently delete a trashed workflow in Dynatrace with the AutomationEngine API and remove it when the workflow is already in trash.

DELETESaaShttps://{your-environment-id}.apps.dynatrace.com/platform/automation/v1/trash/workflows/{id}

Overview

You provide the workflow UUID in the path to delete a trashed workflow in Dynatrace. The adminAccess query parameter can expand access, and the operation returns 204 or 404 if the workflow is missing or not in trash.

Authentication

To execute this request, you need a platform token or OAuth access token with automation:workflows:write scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
idstring

A UUID string identifying this workflow.

pathRequired
adminAccessboolean

Allow access to all workflows/executions - additionally requires automation:workflows:admin

queryOptional

Response

Response codes

CodeTypeDescription
204-

No response body

4XXErrorEnvelope-

Response body objects

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
messagestring-
codeinteger-
detailsErrorDetails-

The ErrorDetails object

ElementTypeDescription
errorCodestring-
errorRefstring-

Response body JSON models

{
"error": {
"message": "string",
"code": 1,
"details": {
"errorCode": "string",
"errorRef": "string"
}
}
}
Related tags
Platform APIDynatrace Platform