Try it free

List workflow history records

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

List workflow history records in Dynatrace with the AutomationEngine API for a workflow ID, including the latest record unless you exclude it.

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

Overview

You list history records for the workflow identified by the id path parameter. The all query parameter controls whether the latest historical record is returned, and the response is a 200 result.

Authentication

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.

Parameters

ParameterTypeDescriptionInRequired
adminAccessboolean

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

queryOptional
allboolean

When false, the latest historical record is not returned.

queryOptional
idstring

A UUID string identifying this workflow.

pathRequired

Response

Response codes

CodeTypeDescription
200PaginatedChangeHistory-
4XXErrorEnvelope-

Response body objects

The PaginatedChangeHistory object

ElementTypeDescription
countinteger-
resultsChangeHistory[]-

The ChangeHistory object

ElementTypeDescription
idinteger-
dateCreatedstring-
userstring-
versioninteger-

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
messagestring-
codeinteger-
detailsErrorDetails-

The ErrorDetails object

ElementTypeDescription
errorCodestring-
errorRefstring-

Response body JSON models

{
"count": 123,
"results": [
{
"id": 1,
"dateCreated": "string",
"user": "string",
"version": 1
}
]
}
{
"error": {
"message": "string",
"code": 1,
"details": {
"errorCode": "string",
"errorRef": "string"
}
}
}
Related tags
Platform APIDynatrace Platform