Retrieve an execution in Dynatrace with the Automation API by UUID, returning the execution details for the specified run.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/automation/v1/executions/{id} |
You provide the execution UUID in the id path parameter and can include adminAccess to allow access to all workflows and executions. Dynatrace returns the execution details for that identifier through the Automation API.
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 |
| id | string | A UUID string identifying this execution. | path | Required |
| Code | Type | Description |
|---|---|---|
| 200 | Execution | - |
| 4XX | Error | - |
Execution object| Element | Type | Description |
|---|---|---|
| id | string | - |
| workflow | string | Executed Workflow |
| state | Execution | -The element can hold these values
|
| stateInfo | string | - |
| input | object | - |
| providedInput | object | - |
| params | object | - |
| startedAt | string | - |
| endedAt | string | - |
| runtime | integer | Calculate the runtime of an execution in seconds. If the execution is not ended, runtime is calculated until now. |
| trigger | string | - |
| schedule | string | - |
| eventTrigger | string | - |
| user | string | - |
| actor | string | - |
| title | string | - |
| result | - | - |
| triggerType | Trigger | - |
| workflowVersion | integer | - |
| workflowType | Workflow | - |
| triggerTypeDetail | Trigger | - |
| parentExecution | string | - |
| parentTaskName | string | Parent task execution's name (subworkflows only) |
| rootExecution | string | - |
| rootWorkflow | string | - |
| isDraft | boolean | - |
ExecutionState objectTriggerType objectWorkflowType objectRepresents a Workflow type.
TriggerTypeDetail objectTriggerSubTypeDetail object| Element | Type | Description |
|---|---|---|
| subType | Trigger | - |
TriggerWorkflowDetail object| Element | Type | Description |
|---|---|---|
| workflowTitle | string | - |
| isTaskTest | boolean | - |
TriggerManualDetail object| Element | Type | Description |
|---|---|---|
| userId | string | - |
TriggerSubType objectErrorEnvelope 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 | - |
{"id": "string","workflow": "string","state": "CANCELLED","stateInfo": "string","input": {},"providedInput": {},"params": {},"startedAt": "string","endedAt": "string","runtime": 1,"trigger": "string","schedule": "string","eventTrigger": "string","user": "string","actor": "string","title": "string","result": {},"triggerType": "Manual","workflowVersion": 1,"workflowType": "STANDARD","triggerTypeDetail": {"subType": "CUSTOM"},"parentExecution": "string","parentTaskName": "string","rootExecution": "string","rootWorkflow": "string","isDraft": true}
{"error": {"message": "string","code": 1,"details": {"errorCode": "string","errorRef": "string"}}}