API

00001012000000 · Info · (manual) · #api #manual #zettelstore

The API (short for “Application Programming Interface”) is the primary way to communicate with a running Zettelstore. Most integration with other systems and services is done through the API. The web user interface is just an alternative, secondary way of interacting with a Zettelstore.

Background

The API is HTTP-based and uses JSON as its main encoding format for exchanging messages between a Zettelstore and its client software.

There is an overview zettel that shows the structure of the endpoints used by the API and gives an indication about its use.

While JSON is the main encoding format, it is possible to retrieve zettel representations in other formats. If you want to create a new zettel or to change an existing one, you have to use JSON. There is an overview zettel for encoding formats that describes the valid formats.

Various parts of a zettel can be retrieved. There are the possible values to specify zettel parts.

Authentication

If authentication is enabled, most API calls must include an access token that proves the identity of the caller.

Zettel lists

Working with zettel

Additional links to this zettel