From 742f2e9efb48dbd64a635248c5a215a8307b8210 Mon Sep 17 00:00:00 2001
From: Christian Steinert <chr.steinert@outlook.com>
Date: Tue, 22 Apr 2025 12:22:58 +0200
Subject: [PATCH] Add entity delete endpoint (REST API) to docs (#2646)

---
 docs/api/rest.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/api/rest.md b/docs/api/rest.md
index c42c5240..fc97188e 100644
--- a/docs/api/rest.md
+++ b/docs/api/rest.md
@@ -823,3 +823,19 @@ curl \
 ```
 
 </ApiEndpoint>
+
+<ApiEndpoint path="/api/states/<entity_id>" method="delete">
+
+Deletes an entity with the specified `entity_id`.
+
+Sample `curl` command:
+
+```shell
+curl \
+  -X DELETE \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  http://localhost:8123/api/states/sensor.kitchen_temperature
+```
+
+</ApiEndpoint>