From dce9b88d46227cfe4cceae3b9e2af2813b5d8767 Mon Sep 17 00:00:00 2001
From: tv <tv@krebsco.de>
Date: Fri, 30 Oct 2026 19:32:20 +0100
Subject: api: document store key limitation

---
 docs/openapi.yaml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

(limited to 'docs/openapi.yaml')

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index ba66f08..b863553 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -984,7 +984,11 @@ components:
       name: key
       in: path
       required: true
-      description: Slash-separated store path, e.g. `settings/theme`.
+      description: |
+        Slash-separated store path, e.g. `settings/theme`. A key with `/` in it, or an
+        empty key, can't be named here (neither `%2F` nor `//` helps: the path is
+        split after decoding, and empty segments are `400`); such keys exist only
+        inside a value written at a parent path, and are read through that parent.
       schema:
         type: string
     conflicts:
-- 
cgit v1.3.1