Skip to content

Commit

Permalink
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Move to top, add service calls
Browse files Browse the repository at this point in the history
jesserockz committed Sep 11, 2024
1 parent fa9a49e commit 459ca8b
Showing 1 changed file with 7 additions and 7 deletions.
14 changes: 7 additions & 7 deletions components/api.rst
Original file line number Diff line number Diff line change
@@ -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
@@ -293,13 +300,6 @@ if logs are shown remotely.
User-defined Actions
--------------------

.. 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`` for the foreseeable future. Documentation
will only refer to **Actions**.

It is also possible to get data from Home Assistant to ESPHome with user-defined actions.
When you declare actions in your ESPHome YAML file, they will automatically show up in
Home Assistant and you can call them directly.

0 comments on commit 459ca8b

Please sign in to comment.