Update item data

Update an item's data.

Data in the request body will be deep-merged with the item's current data.

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

On a list with write rules, this is checked against the rules for update 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

123456

curl https://api.jsonpad.io/lists/fc86ad15-9450-469a-8cf0-71a8f21ecc50/items/4490b5d5-b5dc-4014-ad95-dcf4f97600fa/data \
  -H "Content-Type: application/json" \
  -H "x-api-token: <YOUR TOKEN>" \
  -d '{
        "name": "Jane Doe"
      }'

Parameters

required
listIdstringA list id or path name.
required
itemIdstringAn item id or alias.
optional
includeDatabooleanhttps://api.jsonpad.io/lists/c3df47df-9817-43c2-8d40-2be6bd73a9f3/items/d3a4f024-8f84-436c-bd5e-7fa1e6e846e9/data?includeData=true
Whether to include the item data in the response or not. Can be true or false.
Defaults to true.
optional
includeGuardedboolean?includeGuarded=true
Include values hidden by guard indexes in the response. Can be true or false.
This only applies when the request is authenticated as an identity, and only to the items that identity owns. Without an identity, guarded values stay hidden.
Defaults to false.

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

{name: "Jane Doe"
}

required
*anyData to be deep-merged with the item's current data.

Response body

200 OK

{id: "e82f097b-4a67-4a07-80aa-0431f7c72fbc"
createdAt: "2026-09-23T21:08:24.628Z"
updatedAt: "2026-09-23T21:08:24.628Z"
data: {name: "John Doe"
age: 30
locations: [0: {city: "New York"
state: "NY"
}
1: {city: "Los Angeles"
state: "CA"
}
]
}
version: "1"
readonly: false
activated: true
description: "This is a sample item"
tags: [0: "my-app"
]
size: 111
locked: false
identity: {id: "593d99d0-a8c1-4a3b-a901-bd9d0e8500ab"
displayName: "Sample Display Name"
}
}

Response headers

etagaf2bdbe1aa9b6ec1e2ade1d694f41fc71a831d0268e9891562113d8a62add1bfA SHA-256 hash of the item.
last-modified2026-09-23T21:08:24.628ZThe date this item was last modified.

2026-09-22