From 922ec42bf461daa3d4d31bb9f20cb2efb2c8eedf Mon Sep 17 00:00:00 2001
From: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
Date: Thu, 12 Sep 2024 10:11:50 +1200
Subject: [PATCH] Add note about service -> action change (#4244)

---
 components/api.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/api.rst b/components/api.rst
index 398c46b14..530130265 100644
--- a/components/api.rst
+++ b/components/api.rst
@@ -19,6 +19,13 @@ The ESPHome native API is based on a custom TCP protocol using protocol buffers.
 the protocol data structure definitions here: `api.proto <https://github.com/esphome/esphome/blob/dev/esphome/components/api/api.proto>`__
 A Python library that implements this protocol is `aioesphomeapi <https://github.com/esphome/aioesphomeapi>`__.
 
+.. note::
+
+    **Actions** were previously called **Services**. ESPHome changed the name in line with
+    `Home Assistant <https://developers.home-assistant.io/blog/2024/07/16/service-actions/>`__
+    but will continue to support YAML with ``services`` and ``homeassistant.service`` for the foreseeable future.
+    Documentation will only refer to **Actions**.
+
 .. code-block:: yaml
 
     # Example configuration entry