From a065990ab9f4818342579d0ed49fc1d1a1697002 Mon Sep 17 00:00:00 2001
From: Roger Fachini <r3fachini@live.com>
Date: Tue, 16 Dec 2025 19:20:12 -0800
Subject: [PATCH] [update] Add check action to trigger update checks (#12415)

---
 esphome/components/update/__init__.py  | 18 ++++++++++++++++++
 esphome/components/update/automation.h |  5 +++++
 tests/components/update/common.yaml    |  2 ++
 3 files changed, 25 insertions(+)

diff --git a/esphome/components/update/__init__.py b/esphome/components/update/__init__.py
index 7a381c85a8..e146f7e685 100644
--- a/esphome/components/update/__init__.py
+++ b/esphome/components/update/__init__.py
@@ -29,6 +29,9 @@ UpdateInfo = update_ns.struct("UpdateInfo")
 PerformAction = update_ns.class_(
     "PerformAction", automation.Action, cg.Parented.template(UpdateEntity)
 )
+CheckAction = update_ns.class_(
+    "CheckAction", automation.Action, cg.Parented.template(UpdateEntity)
+)
 IsAvailableCondition = update_ns.class_(
     "IsAvailableCondition", automation.Condition, cg.Parented.template(UpdateEntity)
 )
@@ -143,6 +146,21 @@ async def update_perform_action_to_code(config, action_id, template_arg, args):
     return var
 
 
+@automation.register_action(
+    "update.check",
+    CheckAction,
+    automation.maybe_simple_id(
+        {
+            cv.GenerateID(): cv.use_id(UpdateEntity),
+        }
+    ),
+)
+async def update_check_action_to_code(config, action_id, template_arg, args):
+    var = cg.new_Pvariable(action_id, template_arg)
+    await cg.register_parented(var, config[CONF_ID])
+    return var
+
+
 @automation.register_condition(
     "update.is_available",
     IsAvailableCondition,
diff --git a/esphome/components/update/automation.h b/esphome/components/update/automation.h
index 8563b855fe..af24c838b1 100644
--- a/esphome/components/update/automation.h
+++ b/esphome/components/update/automation.h
@@ -14,6 +14,11 @@ template<typename... Ts> class PerformAction : public Action<Ts...>, public Pare
   void play(const Ts &...x) override { this->parent_->perform(this->force_.value(x...)); }
 };
 
+template<typename... Ts> class CheckAction : public Action<Ts...>, public Parented<UpdateEntity> {
+ public:
+  void play(const Ts &...x) override { this->parent_->check(); }
+};
+
 template<typename... Ts> class IsAvailableCondition : public Condition<Ts...>, public Parented<UpdateEntity> {
  public:
   bool check(const Ts &...x) override { return this->parent_->state == UPDATE_STATE_AVAILABLE; }
diff --git a/tests/components/update/common.yaml b/tests/components/update/common.yaml
index 521a0a6a5c..40042945c8 100644
--- a/tests/components/update/common.yaml
+++ b/tests/components/update/common.yaml
@@ -9,6 +9,8 @@ esphome:
             update.is_available:
           then:
             - logger.log: "Update available"
+          else:
+            - update.check:
       - update.perform:
           force_update: true