start item management, delete works

[lsl.git] / doc / protocol.md

diff --git a/doc/protocol.md b/doc/protocol.md
index 25ab284d2067f48cc2937603799867ce70b67c6e..7d5de4e880d5364bdd5a990c4d38dde35e94606c 100644 (file)
--- a/doc/protocol.md
+++ b/doc/protocol.md
@@ -132,3 +132,14 @@ Possible error responses:
    the differences to the user and either cancel the request and keep the newly
    fetched data as current, or re-submit the change using the fresh version
    number.
+
+DELETE /list/$list_id/$item_id
+------------------------------
+
+Deletes a list item. No request body. Always succeeds, even if the list item
+doesn't exist server-side, in which case the `list_version` isn't changed.
+
+Returns JSON object with the following keys:
+
+ - `list_version`: the new version of the shopping list whose item was deleted.
+ - `lists_version`: the current version of the list of shopping lists