From dc828d4e7b15c22e2a5bcdf8dc4713364e6ebb56 Mon Sep 17 00:00:00 2001 From: Raman Gupta <7243222+raman325@users.noreply.github.com> Date: Mon, 20 Jan 2020 01:16:12 -0500 Subject: [PATCH] Add note under /api/states API endpoint section to distinguish between state updates and service calls (#390) * add note under states API endpoint to distinguish between stateupdates and service calls * update docs per review * grammar * remove word --- docs/external_api_rest.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/external_api_rest.md b/docs/external_api_rest.md index 7e1640d2..9b871528 100644 --- a/docs/external_api_rest.md +++ b/docs/external_api_rest.md @@ -349,6 +349,8 @@ $ curl -X GET -H "Authorization: Bearer ABCDEFGH" \ Updates or creates a state. You can create any state that you want, it does not have to be backed by an entity in Home Assistant. +> :info: NOTE: This endpoint sets the representation of a device within Home Asistant and will not communicate with the actual device. To communicate with the device, use the [POST /api/services/<domain>/<service>](#post-apiservicesltdomainltservice) endpoint. + Expects a JSON object that has at least a state attribute: ```json