Move a workflow to trash or permanently delete it in Dynatrace with the AutomationEngine API by providing the workflow ID and trash option.
| DELETE | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/automation/v1/workflows/{id} |
You provide the workflow ID in the path and can set the trash query parameter to move the workflow to trash instead of deleting it. Dynatrace returns no response body when the AutomationEngine API deletes the workflow.
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.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin | query | Optional |
| id | string | A UUID string identifying this workflow. | path | Required |
| trash | boolean | When | query | Optional |
| Code | Type | Description |
|---|---|---|
| 204 | - | No response body |
| 4XX | Error | - |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| message | string | - |
| code | integer | - |
| details | Error | - |
ErrorDetails object| Element | Type | Description |
|---|---|---|
| errorCode | string | - |
| errorRef | string | - |
{"error": {"message": "string","code": 1,"details": {"errorCode": "string","errorRef": "string"}}}