Successful (HTTP status 200) response is a JSON object with the following keys:
- - `version`: the curre version of the list
+ - `version`: the current version of the list
- `lists_version`: the new version of the list of lists
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