Cancel a task execution in Dynatrace with the AutomationEngine API for a workflow execution and task name, with optional admin access.
| POST | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/automation/v1/executions/{executionId}/tasks/{id}/cancel |
You use executionId and id to cancel one task execution by workflow execution and task name. If you set adminAccess, you can access all workflows and executions and also need automation:work. The operation returns no response body.
To execute this request, you need a platform token or OAuth access token with automation:workflows:run 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 |
| executionId | string | - | path | Required |
| id | string | Task name | path | Required |
| Code | Type | Description |
|---|---|---|
| 200 | - | 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"}}}