Retries

action retries allow you to automatically retry failed actions based on conditions, time limits, and retry count attempts when an action fails or doesn't meet success criteria, retries can automatically attempt the action again until specific conditions are met or limits are reached overview retries are useful for handling transient failures, network issues, or waiting for external systems to become available you can configure retries to retry actions until a success condition is met limit the number of retry attempts add delays between retry attempts set a maximum duration for retry attempts how retries work retries occur when an action fails and the retry condition ( if expression) evaluates to false if the retry condition evaluates to true , the action is considered successful and no retry is needed retries stop when the retry condition becomes true (success) the maximum number of attempts ( limit ) is reached the maximum duration (15 minutes) expires apply action retries to configure retries for an action add and configure an action click the action, then click configure configure the action inputs as needed next to retry , click the plus icon to expand the section configure the retry parameters until configure a condition expression that determines when retries should stop when this condition evaluates to true , the action is considered successful and retries stop if no condition is set, the action will retry until it succeeds (or until limits are reached) delayed set the time to wait before retrying the action you can specify this in seconds or minutes for example, 30 seconds or 1 minute within set the maximum number of retry attempts once this limit is reached, retries stop and the action fails click apply retries automatically timeout after 15 minutes from the first retry attempt this timeout is fixed and matches the playbook timeout it cannot be configured separately after you configure the retry criteria and click apply , the action will retry according to your configuration until the retry condition ( until ) evaluates to true (success) the maximum number of attempts ( within ) is reached the 15 minute duration expires understand retry behavior retry condition logic the retry condition ( until ) works as follows if condition evaluates to true the action is considered successful, and retries stop immediately if condition evaluates to false the action needs to be retried (if within limits) if condition evaluation fails the action is retried (configuration issue) retry limits retries stop when any of these limits are reached success condition met the until condition evaluates to true attempt limit reached the number of retries equals the within limit duration expired 15 minutes have passed since the first retry attempt the first retry attempt counts toward the within limit for example, if within is set to 3, the action will execute up to 3 times total (1 initial attempt + 2 retries) retry timing delay between retries the delayed parameter determines how long to wait before each retry attempt total duration retries automatically timeout after 15 minutes from the first retry attempt, regardless of the number of attempts example timeline attempt 1 action executes (fails) wait delayed duration (e g , 30 seconds) attempt 2 action retries (fails) wait delayed duration attempt 3 action retries (succeeds or fails) result success (if condition met) or failure (if limit reached) best practices set appropriate conditions use clear, specific conditions in the until field to determine success avoid conditions that might never become true choose reasonable limits set the within limit based on expected failure scenarios too few attempts may cause premature failures; too many may waste resources use delays wisely add delays between retries to allow external systems to recover avoid overwhelming apis with rapid requests give time for transient issues to resolve monitor retry behavior review playbook run history to understand retry patterns and adjust limits accordingly handle retry failures consider adding error handling actions in the on failure path to handle cases where retries are exhausted troubleshooting action retries indefinitely check that the until condition can actually become true if the condition always evaluates to false , retries will continue until limits are reached retries stop too early verify that the within limit is not too low, or that the 15 minute duration hasn't expired condition evaluation errors if the retry condition fails to evaluate (e g , due to missing properties), the action will retry check your condition expression for errors no retries occurring ensure the action is actually failing retries only occur when actions fail and the retry condition is false