title: Endpoints used by the API
role: manual
tags: #api #manual #reference #zettelstore
syntax: zmk
back: 00001006000000 00001012000000 00001012051600 00001012051800 00001012053400 00001012053500 00001012053600 00001012080200 00001012080500
backward: 00001006000000 00001012000000 00001012050200 00001012050400 00001012051200 00001012051400 00001012051600 00001012051800 00001012053200 00001012053300 00001012053400 00001012053500 00001012053600 00001012053800 00001012054200 00001012054600 00001012070500 00001012080100 00001012080200 00001012080500
box-number: 1
copyright: (c) 2020-present by Detlef Stern <ds@zettelstore.de>
created: 20210126175322
forward: 00001004010000 00001006050000 00001012050200 00001012050400 00001012051200 00001012051400 00001012053200 00001012053300 00001012053800 00001012054200 00001012054600 00001012070500 00001012080100
lang: en
license: EUPL-1.2-or-later
modified: 20260605142323
published: 20260605142323
visibility: public

All API endpoints conform to the pattern `[PREFIX]LETTER[/ZETTEL-ID]`, where:



The following letters are currently in use:

| Letter | Without zettel identifier | With [zettel identifier](00001006050000) | Mnemonic |
| :-: | --- | --- | --- |
| `a` | POST: [client authentication](00001012050200) |  | __A__uthenticate |
|  | PUT: [renew access token](00001012050400) |  |  |
| `r` |  | GET: [references](00001012053800) | __R__eference |
| `x` | GET: [retrieve administrative data](00001012070500) |  | E__x__ecute |
|  | POST: [execute command](00001012080100) |  |  |
| `z` | GET: [list zettel](00001012051200)/[query zettel](00001012051400) | GET: [retrieve zettel](00001012053300) | __Z__ettel |
|  | POST: [create new zettel](00001012053200) | PUT: [update zettel](00001012054200) |  |
|  |  | DELETE: [delete zettel](00001012054600) |  |

The full URL will contain either the &ldquo;http&rdquo; or &ldquo;https&rdquo; scheme, a host name, and an optional port number.

The API examples will assume the &ldquo;http&rdquo; schema, the local host &ldquo;127.0.0.1&rdquo;, the default port &ldquo;23123&rdquo;, and the default empty `PREFIX` &ldquo;/&rdquo;.
Therefore, all URLs in the API documentation will begin with &ldquo;http://127.0.0.1:23123/&rdquo;.