API: Retrieve context of an existing zettel

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

The context of an origin zettel consists of those zettel that are somehow connected to the origin zettel. Direct connections of an origin zettel to other zettel are visible via metadata values, such as backward, forward or other values with type identifier or set of identifier.

The context is defined by a direction, a depth, and a limit:

The search for the context of a zettel stops at the home zettel. This zettel is connected to all other zettel. If it is included, the context would become too big and therefore unusable.

To retrieve the context of an existing zettel, use the endpoint /x/{ID}1.

# curl ''
{"id": "00001012053800","meta": {...},"rights":62,"list":[{"id": "00001012921000","meta": {...},"rights":62},{"id": "00001012920800","meta": {...},"rights":62},{"id": "00010000000000","meta": {...},"rights":62}]}

Formatted, this translates into:2

  "id": "00001012053800",
  "meta": {...},
  "rights": 62,
  "list": [
      "id": "00001012921000",
      "meta": {...},
      "id": "00001012920800",
      "meta": {...},
      "id": "00010000000000",
      "meta": {...},


The following top-level JSON keys are returned:

The zettel identifier for which the context was requested.
The metadata of the zettel, encoded as a JSON object.
An integer number that describes the access rights for the given zettel.
A list of JSON objects with keys id, meta, and rights that contains the zettel of the context.

HTTP Status codes

Retrieval was successful, the body contains an appropriate JSON object.
Request was not valid.
You are not allowed to retrieve data of the given zettel.
Zettel not found. You probably used a zettel identifier that is not used in the Zettelstore.
  1. Mnemonic: conteXt ↩︎
  2. Metadata (key meta) are hidden to make the overall structure easier to read. ↩︎