This document explains how automated actions in playbooks can sometimes fail
due to temporary problems like network outages or API rate limits. To make sure
your playbooks are more resilient, you can configure individual actions to
automatically retry if they encounter such failures.
Configure action retries
Action retries help your playbooks recover from temporary failures like
network issues, API rate limits, or service unavailability. These retries apply
to standard playbook actions, such as enrichment, containment, or notifications.
However, retries are not attempted for actions that time out. They also don't
apply to flow control actions (like conditions or playbook blocks), as these
aren't designed to fail in the same way.
To configure retries for an action:
Double-click the relevant action in the playbook designer.
In the sidebar that appears, click theSettingstab, and then click
theRetry on failuretoggle to turn it on.
Specify the following parameters:
Number of retries:Enter how many times the action should
attempt to rerun if it fails.
Delay between retries:Define the delay in seconds, minutes, or
hours between each retry attempt.
In theIf step failssection, select one of the following options
if the action ultimately fails after all retry attempts:
Stop playbook:The playbook execution stops.
Skip step:The playbook continues to the next step.
ClickSave.
How retries appear during playbook execution
When a playbook step with retries runs, you'll see specific statuses and
messages indicating the progress of retry attempts:
If an action fails with retries configured, its status in thePlaybookstab temporarily changes toWaiting for next retrybefore the next attempt.
If the action succeeds after one or more retries, its final status in thePlaybookstab indicates success, along with the number of retries (for
example,Completed after 2 retries).
If the action fails after all retry attempts, its final status indicates
failure, along with the number of retries (for example,Failed after 3
retries).
Relevant information about retry attempts also appears on theCase
Wall.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Configure action retries in playbooks\n=====================================\n\nSupported in: \nGoogle secops [SOAR](/chronicle/docs/secops/google-secops-soar-toc)\n| **Note:** This feature is covered by [Pre-GA Offerings Terms](https://chronicle.security/legal/service-terms/) of the Google Security Operations Service Specific Terms. Pre-GA features might have limited support, and changes to pre-GA features might not be compatible with other pre-GA versions. For more information, see the [Google SecOps Technical Support Service guidelines](https://chronicle.security/legal/technical-support-services-guidelines/) and the [Google SecOps Service Specific Terms](https://chronicle.security/legal/service-terms/).\n\nThis document explains how automated actions in playbooks can sometimes fail\ndue to temporary problems like network outages or API rate limits. To make sure\nyour playbooks are more resilient, you can configure individual actions to\nautomatically retry if they encounter such failures.\n\n### Configure action retries\n\nAction retries help your playbooks recover from temporary failures like\nnetwork issues, API rate limits, or service unavailability. These retries apply\nto standard playbook actions, such as enrichment, containment, or notifications.\n\nHowever, retries are not attempted for actions that time out. They also don't\napply to flow control actions (like conditions or playbook blocks), as these\naren't designed to fail in the same way.\n\nTo configure retries for an action:\n\n1. Double-click the relevant action in the playbook designer.\n2. In the sidebar that appears, click the **Settings** tab, and then click the **Retry on failure** toggle to turn it on.\n3. Specify the following parameters:\n - **Number of retries:** Enter how many times the action should attempt to rerun if it fails.\n - **Delay between retries:** Define the delay in seconds, minutes, or hours between each retry attempt.\n4. In the **If step fails** section, select one of the following options if the action ultimately fails after all retry attempts:\n - **Stop playbook:** The playbook execution stops.\n - **Skip step:** The playbook continues to the next step.\n5. Click **Save**.\n\n### How retries appear during playbook execution\n\nWhen a playbook step with retries runs, you'll see specific statuses and\nmessages indicating the progress of retry attempts:\n\n- If an action fails with retries configured, its status in the **Playbooks** tab temporarily changes to **Waiting for next retry** before the next attempt.\n- If the action succeeds after one or more retries, its final status in the **Playbooks** tab indicates success, along with the number of retries (for example, **Completed after 2 retries**).\n- If the action fails after all retry attempts, its final status indicates failure, along with the number of retries (for example, **Failed after 3\n retries**).\n- Relevant information about retry attempts also appears on the **Case\n Wall**.\n\n**Need more help?** [Get answers from Community members and Google SecOps professionals.](https://security.googlecloudcommunity.com/google-security-operations-2)"]]