List action policy executions
https://{kibana_url}
- GET /api/alerting/v2/execution_history/action_policies
- GET /s/{space_id}/api/alerting/v2/execution_history/action_policies
Refer to Spaces for more information.
Get a paginated list of dispatcher summary events for action policies in the current space.
[Required authorization] Route required privileges: read_alerting-v2-execution-history.
Query Parameters
-
pageinteger · min: 1 · max: 10000 · default: 1required Page number (1-indexed). Defaults to 1.
-
per_pageinteger · min: 1 · max: 100 · default: 20required Number of events per page. Defaults to 20.
-
fromstring · pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ Inclusive ISO datetime lower bound on the event timestamp; overrides the default 24-hour window. Independent of alert_ids — e.g. set it to an alert’s start time to scope results to that alert’s lifetime.
-
tostring · pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ Inclusive ISO datetime upper bound on the event timestamp.
-
alert_idsstring · min: 1 · max: 50 Alert filter. Narrows events to those referencing at least one of the provided alert IDs.
-
sort_field· default: dispatched_atrequired Sort field. Defaults to "dispatched_at".
-
Values:
dispatched_at -
searchstring · min: 1 · max: 256 Free-text search. Matches policy name, rule name, policy/rule ID (case-insensitive).
-
rule_idsstring · min: 1 · max: 50 Explicit rule filter. Narrows events to those referencing at least one of the provided rule IDs. Also unions with the search filter if both are provided.
-
outcomes· min: 1 · max: 3 Outcome filter. When omitted matches all outcomes. Pass one or more of "success", "throttled", "failure" to narrow.
-
Values:
successthrottledfailure
Responses
Returns a paginated list of execution history events.
-
itemsobjectrequired -
action_group_countnumberrequired -
alert_countnumberrequired -
alertsobject · max: 50required -
Alert IDs referenced by this event, bounded to 50. Empty when the event references no alerts. Use
alert_countfor the true total. -
idstringrequired -
dispatched_atstring · pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$required -
errorobject -
Failure details. Omitted when the dispatch did not fail.
-
messagestringrequired -
stack_tracestring -
Omitted when the source recorded no trace.
-
failure_reason -
Values:
missing_api_keyworkflow_not_foundworkflow_disabledschedule_errorlicense_not_supported -
outcomerequired -
Values:
successthrottledfailure -
policyobjectrequired -
rule_countnumberrequired -
Number of rules referenced by this event after search or rule-filter narrowing. Unlike
totalon a list response, this is an exact count and it can exceedrules.lengthwhen the embedded array is truncated to the cap. -
rulesobject · max: 20required -
Rules referenced by this event, bounded to 20. When a search or rule filter narrows the match, this array is intersected with the matched subset server-side. Use
rule_countfor the full count. -
pageinteger · min: 1 · max: 9007199254740991required -
per_pageinteger · min: 1 · max: 9007199254740991required -
search_matchesobject -
Per-type match counts for the active search. Omitted when no search was provided. When is_truncated is true the server ID filter was capped and the result may be truncated.
-
is_truncatedbooleanrequired -
True when the server filter cap was reached and results may be truncated.
-
policiesnumberrequired -
Policies matching the search. This count is an estimate: results above 10,000 may be reported as 10,000.
-
rulesnumberrequired -
Rules matching the search. This count is an estimate: results above 10,000 may be reported as 10,000.
-
totalinteger · min: 0 · max: 9007199254740991required -
The number of action policy events matching the query. This count is an estimate: results above 10,000 may be reported as 10,000.
Indicates an invalid schema or parameters.
-
codestringrequired -
Stable error code you can branch on, for example
INVALID_SCHEDULEorRULE_ALREADY_EXISTS. -
detailsmap string to object -
Optional extra information about the error, for example field validation issues or the
rule_idwhen that ID already exists. -
errorstringrequired -
A short human-readable summary of the error category (e.g., "Not Found", "Bad Request"). Subject to change without notice. Do not parse or rely on its content.
-
messagestringrequired -
A readable explanation of the error. The wording can change without notice. Do not parse this field.
Indicates the request was not authenticated.
-
codestringrequired -
Stable error code you can branch on, for example
INVALID_SCHEDULEorRULE_ALREADY_EXISTS. -
detailsmap string to object -
Optional extra information about the error, for example field validation issues or the
rule_idwhen that ID already exists. -
errorstringrequired -
A short human-readable summary of the error category (e.g., "Not Found", "Bad Request"). Subject to change without notice. Do not parse or rely on its content.
-
messagestringrequired -
A readable explanation of the error. The wording can change without notice. Do not parse this field.
Indicates the user does not have the required privileges to perform the request.
-
codestringrequired -
Stable error code you can branch on, for example
INVALID_SCHEDULEorRULE_ALREADY_EXISTS. -
detailsmap string to object -
Optional extra information about the error, for example field validation issues or the
rule_idwhen that ID already exists. -
errorstringrequired -
A short human-readable summary of the error category (e.g., "Not Found", "Bad Request"). Subject to change without notice. Do not parse or rely on its content.
-
messagestringrequired -
A readable explanation of the error. The wording can change without notice. Do not parse this field.
Indicates an unexpected server-side error.
-
codestringrequired -
Stable error code you can branch on, for example
INVALID_SCHEDULEorRULE_ALREADY_EXISTS. -
detailsmap string to object -
Optional extra information about the error, for example field validation issues or the
rule_idwhen that ID already exists. -
errorstringrequired -
A short human-readable summary of the error category (e.g., "Not Found", "Bad Request"). Subject to change without notice. Do not parse or rely on its content.
-
messagestringrequired -
A readable explanation of the error. The wording can change without notice. Do not parse this field.
Indicates the alerting engine is disabled by the alerting:v2:enabled advanced setting.
-
codestringrequired -
Stable error code you can branch on, for example
INVALID_SCHEDULEorRULE_ALREADY_EXISTS. -
detailsmap string to object -
Optional extra information about the error, for example field validation issues or the
rule_idwhen that ID already exists. -
errorstringrequired -
A short human-readable summary of the error category (e.g., "Not Found", "Bad Request"). Subject to change without notice. Do not parse or rely on its content.
-
messagestringrequired -
A readable explanation of the error. The wording can change without notice. Do not parse this field.