((p "To retrieve information about metadata keys, send an HTTP GET request to the endpoint " (kbd "/x") " with the query parameter " (kbd "data=meta-type") "." " " "If " (a ((href . "00001010040100")) "authentication is enabled") ", the caller must be authenticated and must have at least read access.") (p "Without the query parameter " (kbd "key") ", information about all predefined metadata keys is returned." " " "The order of the entries is not specified and may differ between requests.") (p "If the query parameter " (kbd "key") " is given (possibly more than once), the result contains one entry for each occurrence of " (kbd "key") ", in the given order." " " "If the same key is given more than once, the result contains the entry for that key more than once." " " "An empty value for " (kbd "key") " is rejected with status code " (kbd "400") "." " " "The type of a key that is not predefined is derived from the suffix of its name, see " (a ((href . "00001006030000")) "Supported Key Types") "." " " "For example, the key " (kbd "data-url") " has the type " (kbd "URL") "; a key with a suffix not listed there has the type " (a ((href . "00001006031500")) "EString") ".") (pre (code ((class . "language-sh")) "# curl 'http://127.0.0.1:23123/x?data=meta-type&key=data-url&key=forward&key=unknown'\n((\"data-url\" \"URL\" () () ()) (\"forward\" \"IdentifierSet\" T () T) (\"unknown\" \"EString\" () () ()))")) (p "The result is a list of entries." " " "Each entry is a list of five elements, in this order:") (ol (li "The name of the key, i.e. its string representation (string).") (li "The name of the type of the key (string), as used in " (a ((href . "00001006030000")) "Supported Key Types") ", e.g. " (kbd "\"IdentifierSet\"") ".") (li (kbd "T") ", if the type is a set type, i.e. the value is a set of elements, otherwise " (kbd "()") ".") (li (kbd "T") ", if the key is managed, i.e. the value is set and maintained by Zettelstore and stored in the zettel, otherwise " (kbd "()") ".") (li (kbd "T") ", if the key is a property, i.e. the value is always calculated and never stored, otherwise " (kbd "()") "." " " "The elements 4 and 5 are never both " (kbd "T") "." " " "If both are " (kbd "()") ", the key belongs to the category " (@L (@H "“") "user" (@H "”")) ": the value is set by the user.")) (p "See " (a ((href . "00001006020000")) "Supported Metadata Keys") " for details and for the category of each predefined key.") (h3 ((id . "http-status-codes")) "HTTP Status codes") (dl (dt (kbd "200")) (dd (p "Retrieval was successful, the body contains the list.")) (dt (kbd "400")) (dd (p "The value of the query parameter " (kbd "key") " is empty.")) (dt (kbd "403")) (dd (p "Authentication is enabled, and the caller is not authenticated or does not have read access."))))