Delete an item

Delete an item.

A deleted item's event history is kept, so the item can be restored later.

DELETE https://api.jsonpad.io/lists/{listId}/items/{itemId}

On a list with write rules, this is checked against the rules for delete before anything is written. A write nothing authorises is refused with 403, one that fails a check with 400 and the rule's message, and one whose item changed while it was being written with 409.

Example

123

curl https://api.jsonpad.io/lists/be258fc9-6950-40a7-94c2-0ea6093457ae/items/17a89333-7999-4483-af3e-611e49e98ef7 \
  -X DELETE \
  -H "x-api-token: <YOUR TOKEN>"

Parameters

required
listIdstringA list id or path name.
required
itemIdstringAn item id or alias.

Request headers

required
x-api-tokenstringYour API token.
optional
if-matchstring
The item's ETag, from the etag header of the response you last read or wrote it with.
If the item has changed since then, nothing is written and we return a 412 ("Precondition failed") response. Fetch the item again and retry. See conditional writes.
optional
x-identity-tokenstringAn identity token.
optional
x-identity-groupstringAn identity group.

Request body

No request body

Response body

204 No Content

No response body

Response headers

No response headers

2026-09-22