Try it free

Restore a workflow history version

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Restore a workflow history version in Dynatrace with the AutomationEngine API by workflow ID and version, then deploy the restored workflow.

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

Overview

You restore the workflow identified by the id path parameter to the specified version path parameter. The request also accepts adminAccess, and it returns a 200 response with no body after deployment.

Authentication

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.

Parameters

ParameterTypeDescriptionInRequired
adminAccessboolean

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

queryOptional
idstring

A UUID string identifying this workflow.

pathRequired
versionstring-pathRequired

Response

Response codes

CodeTypeDescription
200-

No response body

4XXErrorEnvelope-

Response body objects

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
messagestring-
codeinteger-
detailsErrorDetails-

The ErrorDetails object

ElementTypeDescription
errorCodestring-
errorRefstring-

Response body JSON models

{
"error": {
"message": "string",
"code": 1,
"details": {
"errorCode": "string",
"errorRef": "string"
}
}
}
Related tags
Platform APIDynatrace Platform