List task executions in Dynatrace with the AutomationEngine API for a workflow execution, using the execution ID and optional admin access.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/automation/v1/executions/{executionId}/tasks |
You use the executionId path parameter to list the task executions for a workflow execution. If you set adminAccess, you can access all workflows and executions and also need automation:work. The response returns the task executions for the specified execution.
To execute this request, you need a platform token or OAuth access token with automation:workflows:read 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 |
| Code | Type | Description |
|---|---|---|
| 200 | Task | - |
| 4XX | Error | - |
TaskExecutions objectTaskExecution object| Element | Type | Description |
|---|---|---|
| id | string | - |
| execution | string | Parent execution |
| name | string | - |
| state | Task | -The element can hold these values
|
| errorReason | string | - |
| stateInfo | string | - |
| input | object | - |
| startedAt | string | - |
| endedAt | string | - |
| runtime | integer | Calculate the runtime of a task execution in seconds. If the task execution is not ended, runtime is calculated until now. |
| position | Task | - |
| conditions | object | - |
| predecessors | string[] | - |
| active | boolean | Whether task is active |
| result | - | - |
| conditionResults | object | - |
| description | string | - |
| action | string | - |
| isApproval | boolean | Whether this task is an approval request |
| packageVersions | object | - |
TaskExecutionState objectTaskPosition object| Element | Type | Description |
|---|---|---|
| x | integer | Grid (not pixel) coordinate in workflow graph. x=0 is horizontal center. |
| y | integer | Grid (not pixel) coordinate in workflow graph. Expands downwards. Must be >= 1. |
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"}}}