Bring your towel and join one of the fastest growing data communities. Welcome to our second-generation open source orchestration platform, a completely rethought approach to dataflow automation.

Prefect Community

<@ULVA73B9P> when adding retries to a task, will the on_failure hooks run after each try, or after retries has been exhausted?

:white_check_mark: thought for 128.9 seconds

Short answer: after retries are exhausted.

In Prefect 3.x, `on_failure` hooks run when the task ultimately enters a Failed state. During retries, failed attempts transition the task into `AwaitingRetry`/`Retrying` (both are running-type states), so `on_failure` does not fire on each attempt. If you want something to run on every attempt, use `on_running` hooks—they fire on each run and retry.

References:
- Task engine hook handling in source: <https://github.com/PrefectHQ/prefect/blob/main/src/prefect/engine/task_engine.py|task_engine.py> (hooks are called based on the final state entered)

If you’re on Prefect 2.x, let me know—behavior and APIs differ there.