(((meta (@ (content . "API: Delete a zettel") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#api #manual #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001012000000") (name . "back"))) (meta (@ (content . "00001012000000 00001012920000") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20210713150005") (name . "created"))) (meta (@ (content . "00001004010000 00001004011200 00001006050000 00001010040100 00001010070600 00001012920000") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20221219154608") (name . "modified"))) (meta (@ (content . "20221219154608") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "Deleting a zettel within the Zettelstore is executed on the first " (a (@ (href . "00001004011200")) "box") " that contains that zettel." " " "Zettel with the same identifier, but in subsequent boxes remain." " " "If the first box containing the zettel is read-only, deleting that zettel will fail, as well for a Zettelstore in " (a (@ (href . "00001004010000#read-only-mode")) "read-only mode") " or if " (a (@ (href . "00001010040100")) "authentication is enabled") " and the user has no " (a (@ (href . "00001010070600")) "access right") " to do so.") (p "The " (a (@ (href . "00001012920000")) "endpoint") " to delete a zettel is " (kbd "/z/{ID}") ", where " (kbd "{ID}") " is a placeholder for the " (a (@ (href . "00001006050000")) "zettel identifier") "." " " "You must send a HTTP DELETE request to this endpoint:") (pre (code "# curl -X DELETE http://127.0.0.1:23123/z/00001000000000")) (h2 (@ (id . "http-status-codes")) "HTTP Status codes") (dl (dt (kbd "204")) (dd (p "Delete was successful, there is no body in the response.")) (dt (kbd "403")) (dd (p "You are not allowed to delete the given zettel." " " "Maybe you do not have enough access rights, or either the box or Zettelstore itself operate in read-only mode.")) (dt (kbd "404")) (dd (p "Zettel not found." " " "You probably specified a zettel identifier that is not used in the Zettelstore."))))