From 5803203e9e91634b07655fc98e7b8f9fcef3a5e9 Mon Sep 17 00:00:00 2001
From: Michael Geers <michael@geers.tv>
Date: Tue, 5 May 2026 08:52:01 +0200
Subject: [PATCH] docs: clarify loadpoint limitsoc (#29643)

---
 server/mcp/openapi.json | 4 ++--
 server/mcp/openapi.md   | 2 +-
 server/openapi.yaml     | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/server/mcp/openapi.json b/server/mcp/openapi.json
index 60e0342df..2004cfd96 100644
--- a/server/mcp/openapi.json
+++ b/server/mcp/openapi.json
@@ -1271,7 +1271,7 @@
     },
     "/loadpoints/{id}/limitsoc/{soc}": {
       "post": {
-        "description": "Updates the SoC limit of the loadpoint. Requires a connected vehicle with known SoC. Limit is maintained across charging sessions.",
+        "description": "Sets the session SoC limit. Cleared on disconnect. Takes precedence over the vehicle's configured limit while set; once cleared (set to 0), the vehicle limit applies again.",
         "externalDocs": {
           "url": "https://docs.evcc.io/en/docs/features/limit"
         },
@@ -1289,7 +1289,7 @@
             "$ref": "#/components/responses/NumberResult"
           }
         },
-        "summary": "Update limit SoC",
+        "summary": "Update session SoC limit",
         "tags": [
           "loadpoints"
         ]
diff --git a/server/mcp/openapi.md b/server/mcp/openapi.md
index 6859151b7..d657b8a6e 100644
--- a/server/mcp/openapi.md
+++ b/server/mcp/openapi.md
@@ -836,7 +836,7 @@ call setLoadpointSmartFeedInPriorityLimit {
 
 ## setLoadpointSocLimit
 
-Updates the SoC limit of the loadpoint. Requires a connected vehicle with known SoC. Limit is maintained across charging sessions.
+Sets the session SoC limit. Cleared on disconnect. Takes precedence over the vehicle's configured limit while set; once cleared (set to 0), the vehicle limit applies again.
 
 **Tags:** loadpoints
 
diff --git a/server/openapi.yaml b/server/openapi.yaml
index e4963e645..26ca0be20 100644
--- a/server/openapi.yaml
+++ b/server/openapi.yaml
@@ -296,8 +296,8 @@ paths:
   /loadpoints/{id}/limitsoc/{soc}:
     post:
       operationId: setLoadpointSocLimit
-      summary: Update limit SoC
-      description: "Updates the SoC limit of the loadpoint. Requires a connected vehicle with known SoC. Limit is maintained across charging sessions."
+      summary: Update session SoC limit
+      description: "Sets the session SoC limit. Cleared on disconnect. Takes precedence over the vehicle's configured limit while set; once cleared (set to 0), the vehicle limit applies again."
       externalDocs:
         url: https://docs.evcc.io/en/docs/features/limit
       tags: