No results

Restore an item

Restore an item to the state it was in when the specified event was created. This can also be used to restore an item that has been deleted.

POST https://api.jsonpad.io/lists/{listId}/items/{itemId}/events/{eventId}/restore

When an item is restored, the data, description, readonly and activated fields will be restored to the values they had when the specified event was created. A new version will be created containing the restored state, and the version number will be incremented.

If the item has been deleted, it will be re-created with the same id. Deleted items must be referenced by id (not by alias), and restoring a deleted item counts towards the maximum number of items allowed in a list.

Use the Fetch item events endpoint with restorable=true to find events that an item can be restored from. Restoring an item requires the restore (or restore-with-identity) token permission.

Example

cURL
1234curl https://api.jsonpad.io/lists/55cece36-2361-4892-ab87-dcd2cfdea7a2/items/89d19cc9-05c9-4201-9e19-a3d1e2b3e8a2/events/d69ade46-1e99-4631-858e-27f6b894b853/restore \
  -X POST \
  -H "Content-Type: application/json" \
  -H "x-api-token: <YOUR TOKEN>"

Parameters

  • required
    listIdstringA list id or path name.
  • required
    itemIdstringAn item id or alias. Deleted items must be referenced by id.
  • required
    eventIdstring

    The id of the event to restore the item from.

    This must be an item-created, item-updated, item-restored or item-deleted event for this item.

  • optional
    includeDatabooleanhttps://api.jsonpad.io/lists/0e45717f-bdc7-428e-b19e-65e8d529e495/items/9f2a5983-f3c5-4296-88be-921aa9d62e72/events/5bc341fd-1f9f-46b0-a0e0-78e963e22e7f/restore?includeData=true

    Whether to include the item data in the response or not. Can be true or false.

    Defaults to true.

Request headers

  • required
    x-api-tokenstringYour API token.
  • optional
    x-identity-tokenstringAn identity token.
  • optional
    x-identity-groupstringAn identity group.

Request body

No request body

Response body

200 OK
{
id: "a86e15b7-af25-4b0f-bab4-6e62bb8a6ea0"
createdAt: "2026-09-11T16:55:37.415Z"
updatedAt: "2026-09-11T16:55:37.415Z"
data: {
test: 123
}
version: "3"
readonly: false
activated: true
description: "This is a sample item"
size: 12
}

Response headers

  • etagaf2bdbe1aa9b6ec1e2ade1d694f41fc71a831d0268e9891562113d8a62add1bfA SHA-256 hash of the item.
  • last-modified2026-09-11T16:55:37.415ZThe date this item was last modified.
2026-09-11