title: API: Delete a zettel
role: manual
tags: #api #manual #zettelstore
syntax: zmk
back: 00001012000000
backward: 00001012000000 00001012920000
box-number: 1
copyright: (c) 2020-present by Detlef Stern <ds@zettelstore.de>
created: 20210713150005
forward: 00001004011200 00001006050000 00001010040100 00001010070600 00001012920000
lang: en
license: EUPL-1.2-or-later
modified: 20251215173247
published: 20251215173247
visibility: public

Deleting a zettel within the Zettelstore is executed on the first [box](00001004011200) that contains that zettel.
Zettel with the same identifier, but in subsequent boxes remain.
If the first box containing the zettel is read-only, deleting that zettel will fail, as well for a Zettelstore in [read-only mode](00001004010000#read-only-mode) or if [authentication is enabled](00001010040100) and the user has no [access right](00001010070600) to do so.

The [endpoint](00001012920000) to delete a zettel is `/z/{ID}`, where `{ID}` is a placeholder for the [zettel identifier](00001006050000).
You must send an HTTP DELETE request to this endpoint:

    # curl -X DELETE http://127.0.0.1:23123/z/00001000000000

# HTTP Status codes