v0.8.19

docs/API.md

@@ -1,6 +1,6 @@
 # GREE Controller API reference
 
-HTTP and WebSocket API for GREE Controller **0.8.17**.
+HTTP and WebSocket API for GREE Controller **0.8.19**.
 
 [← Main documentation](../README.md)
 
@@ -137,7 +137,7 @@ Common statuses:
 | GET | `/api/groups/{id}` | Read a group. |
 | PUT | `/api/groups/{id}` | Replace group definition. |
 | DELETE | `/api/groups/{id}` | Delete a group. |
-| POST | `/api/groups/{id}/control` | Group power/mode/preset control. |
+| POST | `/api/groups/{id}/control` | Group power/mode/preset/custom-temperature control. |
 | POST | `/api/house/control` | Set global thermostat mode. |
 | POST | `/api/house/power` | Set whole-house master power. |
 | POST | `/api/house/preset` | Set/clear whole-house preset override. |
@@ -212,7 +212,7 @@ Response:
 {
   "status": "ok",
   "name": "gree-controller",
-  "version": "0.8.17",
+  "version": "0.8.19",
   "uptime_seconds": 1234,
   "control_ready": true,
   "time": "2026-08-30T06:54:00Z"
@@ -236,7 +236,7 @@ Returns the initial Web UI snapshot:
   "settings": {},
   "outdoor_temperature": null,
   "system": {
-    "version": "0.8.17",
+    "version": "0.8.19",
     "uptime_seconds": 1234,
     "auth_required": false,
     "control_ready": true,
@@ -655,7 +655,8 @@ Read, replace or delete a group. `DELETE` returns `204`.
 {
   "power": true,
   "mode": "house",
-  "preset": "comfort"
+  "preset": "custom",
+  "setpoint": 22.3
 }
 ```
 
@@ -663,9 +664,10 @@ All fields optional:
 
 - `power`: group gate,
 - `mode`: `house`, `cool`, `heat`,
-- `preset`: `auto`, `comfort`, `sleep`, `away`.
+- `preset`: `auto`, `comfort`, `sleep`, `away`, `custom`,
+- `setpoint`: custom group target in the `8–30°C` range; requires `preset: "custom"`.
 
-Returns a group control/result object including updated members/state.
+A custom setpoint creates the same temporary manual override for every member zone and normally expires at that zone's next schedule boundary. Returns a group control/result object including updated members/state.
 
 ---