((META (EMPTY-STRING title "API: Create a new zettel") (WORD role "manual") (TAG-SET tags ("#api" "#manual" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001005000000" "00001012054200")) (ZID-SET backward ("00001005000000" "00001012000000" "00001012054200" "00001012920000")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20210713150005") (ZID-SET forward ("00001006000000" "00001006010000" "00001006020000" "00001006050000" "00001012000000" "00001012053300" "00001012920000" "00001012921200" "00001012930500")) (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20230807170416") (TIMESTAMP published "20230807170416") (WORD visibility "public")) (BLOCK (PARA (TEXT "A") (SPACE) (TEXT "zettel") (SPACE) (TEXT "is") (SPACE) (TEXT "created") (SPACE) (TEXT "by") (SPACE) (TEXT "adding") (SPACE) (TEXT "it") (SPACE) (TEXT "to") (SPACE) (TEXT "the") (SPACE) (LINK-ZETTEL () "00001012000000" (TEXT "list") (SPACE) (TEXT "of") (SPACE) (TEXT "zettel")) (TEXT ".") (SOFT) (TEXT "Therefore,") (SPACE) (TEXT "the") (SPACE) (LINK-ZETTEL () "00001012920000" (TEXT "endpoint")) (SPACE) (TEXT "to") (SPACE) (TEXT "create") (SPACE) (TEXT "a") (SPACE) (TEXT "new") (SPACE) (TEXT "zettel") (SPACE) (TEXT "is") (SPACE) (TEXT "also") (SPACE) (LITERAL-INPUT () "/z") (TEXT ",") (SPACE) (TEXT "but") (SPACE) (TEXT "you") (SPACE) (TEXT "must") (SPACE) (TEXT "send") (SPACE) (TEXT "the") (SPACE) (TEXT "data") (SPACE) (TEXT "of") (SPACE) (TEXT "the") (SPACE) (TEXT "new") (SPACE) (TEXT "zettel") (SPACE) (TEXT "via") (SPACE) (TEXT "a") (SPACE) (TEXT "HTTP") (SPACE) (TEXT "POST") (SPACE) (TEXT "request.")) (PARA (TEXT "The") (SPACE) (TEXT "zettel") (SPACE) (TEXT "must") (SPACE) (TEXT "be") (SPACE) (TEXT "encoded") (SPACE) (TEXT "in") (SPACE) (TEXT "a") (SPACE) (LINK-ZETTEL () "00001006000000" (TEXT "plain")) (SPACE) (TEXT "format:") (SPACE) (TEXT "first") (SPACE) (TEXT "comes") (SPACE) (TEXT "the") (SPACE) (LINK-ZETTEL () "00001006010000" (TEXT "metadata")) (SPACE) (TEXT "and") (SPACE) (TEXT "the") (SPACE) (TEXT "following") (SPACE) (TEXT "content") (SPACE) (TEXT "is") (SPACE) (TEXT "separated") (SPACE) (TEXT "by") (SPACE) (TEXT "an") (SPACE) (TEXT "empty") (SPACE) (TEXT "line.") (SOFT) (TEXT "This") (SPACE) (TEXT "is") (SPACE) (TEXT "the") (SPACE) (TEXT "same") (SPACE) (TEXT "format") (SPACE) (TEXT "as") (SPACE) (TEXT "used") (SPACE) (TEXT "by") (SPACE) (TEXT "storing") (SPACE) (TEXT "zettel") (SPACE) (TEXT "within") (SPACE) (TEXT "a") (SPACE) (LINK-ZETTEL () "00001006010000" (TEXT "directory") (SPACE) (TEXT "box")) (TEXT ".")) (VERBATIM-CODE () "# curl -X POST --data $'title: Note\\n\\nImportant content.' http://127.0.0.1:23123/z\n20210903211500") (PARA (TEXT "The") (SPACE) (TEXT "zettel") (SPACE) (TEXT "identifier") (SPACE) (TEXT "of") (SPACE) (TEXT "the") (SPACE) (TEXT "created") (SPACE) (TEXT "zettel") (SPACE) (TEXT "is") (SPACE) (TEXT "returned.") (SOFT) (TEXT "In") (SPACE) (TEXT "addition,") (SPACE) (TEXT "the") (SPACE) (TEXT "HTTP") (SPACE) (TEXT "response") (SPACE) (TEXT "header") (SPACE) (TEXT "contains") (SPACE) (TEXT "a") (SPACE) (TEXT "key") (SPACE) (LITERAL-INPUT () "Location") (SPACE) (TEXT "with") (SPACE) (TEXT "a") (SPACE) (TEXT "relative") (SPACE) (TEXT "URL") (SPACE) (TEXT "for") (SPACE) (TEXT "the") (SPACE) (TEXT "new") (SPACE) (TEXT "zettel.") (SOFT) (TEXT "A") (SPACE) (TEXT "client") (SPACE) (TEXT "must") (SPACE) (TEXT "prepend") (SPACE) (TEXT "the") (SPACE) (TEXT "HTTP") (SPACE) (TEXT "protocol") (SPACE) (TEXT "scheme,") (SPACE) (TEXT "the") (SPACE) (TEXT "host") (SPACE) (TEXT "name,") (SPACE) (TEXT "and") (SPACE) (TEXT "(optional,") (SPACE) (TEXT "but") (SPACE) (TEXT "often") (SPACE) (TEXT "needed)") (SPACE) (TEXT "the") (SPACE) (TEXT "post") (SPACE) (TEXT "number") (SPACE) (TEXT "to") (SPACE) (TEXT "make") (SPACE) (TEXT "it") (SPACE) (TEXT "an") (SPACE) (TEXT "absolute") (SPACE) (TEXT "URL.")) (HEADING 1 () "data-input" "data-input" (TEXT "Data") (SPACE) (TEXT "input")) (PARA (TEXT "Alternatively,") (SPACE) (TEXT "you") (SPACE) (TEXT "may") (SPACE) (TEXT "encode") (SPACE) (TEXT "the") (SPACE) (TEXT "zettel") (SPACE) (TEXT "as") (SPACE) (TEXT "a") (SPACE) (TEXT "parseable") (SPACE) (TEXT "object") (SPACE) (TEXT "/") (SPACE) (TEXT "a") (SPACE) (LINK-ZETTEL () "00001012930500" (TEXT "symbolic") (SPACE) (TEXT "expression")) (SPACE) (TEXT "by") (SPACE) (TEXT "providing") (SPACE) (TEXT "the") (SPACE) (TEXT "query") (SPACE) (TEXT "parameter") (SPACE) (LITERAL-INPUT () "enc=data") (TEXT ".") (SOFT) (TEXT "The") (SPACE) (TEXT "encoding") (SPACE) (TEXT "is") (SPACE) (TEXT "the") (SPACE) (TEXT "same") (SPACE) (TEXT "as") (SPACE) (TEXT "the") (SPACE) (TEXT "data") (SPACE) (TEXT "output") (SPACE) (TEXT "encoding") (SPACE) (TEXT "when") (SPACE) (TEXT "you") (SPACE) (LINK-ZETTEL () "00001012053300#data-output" (TEXT "retrieve") (SPACE) (TEXT "a") (SPACE) (TEXT "zettel")) (TEXT ".")) (PARA (TEXT "The") (SPACE) (TEXT "encoding") (SPACE) (TEXT "for") (SPACE) (LINK-ZETTEL () "00001012921200" (TEXT "access") (SPACE) (TEXT "rights")) (SPACE) (TEXT "must") (SPACE) (TEXT "be") (SPACE) (TEXT "given,") (SPACE) (TEXT "but") (SPACE) (TEXT "is") (SPACE) (TEXT "ignored.") (SOFT) (TEXT "You") (SPACE) (TEXT "may") (SPACE) (TEXT "encode") (SPACE) (TEXT "computed") (SPACE) (TEXT "or") (SPACE) (TEXT "property") (SPACE) (LINK-ZETTEL () "00001006020000" (TEXT "metadata") (SPACE) (TEXT "keys")) (TEXT ",") (SPACE) (TEXT "but") (SPACE) (TEXT "these") (SPACE) (TEXT "are") (SPACE) (TEXT "also") (SPACE) (TEXT "ignored.")) (HEADING 1 () "http-status-codes" "http-status-codes" (TEXT "HTTP") (SPACE) (TEXT "Status") (SPACE) (TEXT "codes")) (DESCRIPTION ((LITERAL-INPUT () "201")) (BLOCK (BLOCK (PARA (TEXT "Zettel") (SPACE) (TEXT "creation") (SPACE) (TEXT "was") (SPACE) (TEXT "successful,") (SPACE) (TEXT "the") (SPACE) (TEXT "body") (SPACE) (TEXT "contains") (SPACE) (TEXT "its") (SPACE) (LINK-ZETTEL () "00001006050000" (TEXT "zettel") (SPACE) (TEXT "identifier")) (SPACE) (TEXT "(data") (SPACE) (TEXT "value") (SPACE) (TEXT "or") (SPACE) (TEXT "plain") (SPACE) (TEXT "text).")))) ((LITERAL-INPUT () "400")) (BLOCK (BLOCK (PARA (TEXT "Request") (SPACE) (TEXT "was") (SPACE) (TEXT "not") (SPACE) (TEXT "valid.") (SPACE) (SOFT) (TEXT "There") (SPACE) (TEXT "are") (SPACE) (TEXT "several") (SPACE) (TEXT "reasons") (SPACE) (TEXT "for") (SPACE) (TEXT "this.") (SOFT) (TEXT "Most") (SPACE) (TEXT "likely,") (SPACE) (TEXT "the") (SPACE) (TEXT "symbolic") (SPACE) (TEXT "expression") (SPACE) (TEXT "was") (SPACE) (TEXT "not") (SPACE) (TEXT "formed") (SPACE) (TEXT "according") (SPACE) (TEXT "to") (SPACE) (TEXT "above") (SPACE) (TEXT "rules.")))) ((LITERAL-INPUT () "403")) (BLOCK (BLOCK (PARA (TEXT "You") (SPACE) (TEXT "are") (SPACE) (TEXT "not") (SPACE) (TEXT "allowed") (SPACE) (TEXT "to") (SPACE) (TEXT "create") (SPACE) (TEXT "a") (SPACE) (TEXT "new") (SPACE) (TEXT "zettel.")))))))