API reference · Automation
POST/api/v1/automation/executions/{id}/retry
Product availabilityAlgaPSA

Retry automation execution

Retries a failed automation execution. The controller authenticates with x-api-key, requires automation:execute permission, validates the execution UUID, resets a failed execution to pending, clears completion/error counters, queues the execution, publishes automation.execution.retried, and returns the updated execution with links. The service only allows status=failed; missing executions and non-failed executions currently throw generic Errors and may surface as 500 rather than 404 or 400. The queueExecution helper is currently a stub.

RBAC · automation

Path parameters

idstring <uuid>Required
Automation execution UUID from automation_executions.execution_id.

Response body

Success response 200 · schema AutomationExecutionResponse

dataobjectRequired
execution_idstring <uuid>Required
Execution UUID generated with crypto.randomUUID when the execution is created.
automation_rule_idstring <uuid>Required
Parent automation rule UUID.
trigger_dataobject
Trigger payload captured when execution started.
statusstringRequired
Current execution status.
Enum: pendingrunningcompletedfailedcancelledtimeoutskipped
started_atstring <date-time>
Timestamp when execution started.
completed_atstring <date-time>Nullable
Timestamp when execution completed.
duration_msnumberNullable
Execution duration in milliseconds.
≥ 0
actions_totalintegerRequired
Number of actions planned for this execution.
≥ 0
actions_successfulintegerRequired
Number of actions completed successfully.
≥ 0
actions_failedintegerRequired
Number of actions that failed.
≥ 0
error_messagestringNullable
Top-level error message, when failed.
error_stackstringNullable
Error stack, when captured.
failed_action_indexintegerNullable
Index of failed action, when applicable.
execution_contextobject
Execution context data.
logsarray of AutomationExecutionLogEntry
Execution log entries.
itemsobject
timestampstring <date-time>
Log timestamp.
levelstringRequired
Log level.
Enum: debuginfowarnerror
messagestringRequired
Log message.
action_indexinteger
Optional action index that produced the log.
metadataobject
Optional structured log metadata.
tenantstring <uuid>Required
Tenant UUID scoped from the API key context.
_linksobject
HATEOAS links generated by the automation controller. Some generic links may point to methods not implemented by a route file.

Response codes

200
Execution reset and queued for retry.
400
Invalid execution UUID format, or intended response when execution is not failed.
401
API key is missing, invalid, expired, over limit, or the key user was not found.
403
Authenticated user lacks automation:execute permission.
404
Intended not-found response for a missing execution; current service may surface this as 500.
500
Unexpected failure, including current generic not-found or not-failed errors.