API reference · Automation
GET/api/v1/automation/executions

List automation executions

Returns a paginated list of automation executions for the authenticated tenant. Authentication uses x-api-key with optional x-tenant-id; the controller validates the API key, resolves the user and tenant, runs under tenant context, and requires automation:read permission. The service forces tenant into the execution query conditions. Current service code appears to wrap the execution array in another array before createPaginatedResponse, which may produce nested data in practice.

RBAC · automation

Query parameters

pagestringOptional
Page number as a query string. Defaults to 1.
limitstringOptional
Page size as a query string. Must parse to 1 through 100; defaults to 25.
sortstringOptional
Accepted by shared list query validation; the service currently orders executions by started_at desc.
orderstringOptional
Accepted by shared list query validation.
searchstringOptional
Accepted by shared filter validation.
created_fromstring <date-time>Optional
Accepted by shared filter validation.
created_tostring <date-time>Optional
Accepted by shared filter validation.
updated_fromstring <date-time>Optional
Accepted by shared filter validation.
updated_tostring <date-time>Optional
Accepted by shared filter validation.
is_activestringOptional
Accepted by shared filter validation and transformed to boolean.
automation_rule_idstring <uuid>Optional
Filter executions by parent automation rule UUID.
statusstringOptional
Filter by execution status.
started_fromstring <date-time>Optional
Filter executions started at or after this timestamp.
started_tostring <date-time>Optional
Filter executions started at or before this timestamp.
duration_min_msnumberOptional
Minimum execution duration in milliseconds.
duration_max_msnumberOptional
Maximum execution duration in milliseconds.
has_errorsstringOptional
Filter by whether the execution has errors; transformed to boolean by validation.
trigger_typestringOptional
Filter by automation trigger type.

Response body

Success response 200 · schema AutomationExecutionListResponse

dataarray of AutomationExecutionRequired
Automation execution rows. Current service code wraps the DB result array in another array; this schema documents the intended flat shape returned by createPaginatedResponse.
itemsobject
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.
paginationobjectRequired
pageintegerRequired
Current page number.
limitintegerRequired
Page size.
totalintegerRequired
Total matching executions.
totalPagesintegerRequired
Total page count.
hasNextbooleanRequired
Whether another page exists.
hasPrevbooleanRequired
Whether a previous page exists.
metaobject
filtersobject
Validated filters echoed by the controller.
resourcestring
Resource name supplied by the controller.
Enum: automation_execution

Response codes

200
Automation executions returned successfully.
400
Query parameter validation failed.
401
API key is missing, invalid, expired, over limit, or the key user was not found.
403
Authenticated user lacks automation:read permission.
500
Unexpected automation execution listing failure.