Replace item data

Replace an item's data.

PUT 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

123456789101112131415161718

curl https://api.jsonpad.io/lists/d5e90a10-5f32-467c-882d-bfa6ac14b1d9/items/97d32a96-8419-4043-96d4-e91aef8222a8/data \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "x-api-token: <YOUR TOKEN>" \
  -d '{
        "name": "Jane Doe",
        "age": 40,
        "locations": [
          {
            "city": "Chicago",
            "state": "IL"
          },
          {
            "city": "Houston",
            "state": "TX"
          }
        ]
      }'

Parameters

required
listIdstringA list id or path name.
required
itemIdstringAn item id or alias.
optional
includeDatabooleanhttps://api.jsonpad.io/lists/ac8be157-2ac6-4960-a894-d12b70575d28/items/4b3fc23b-d807-474e-8e74-3dd0acef0ece/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"
age: 40
locations: [0: {city: "Chicago"
state: "IL"
}
1: {city: "Houston"
state: "TX"
}
]
}

required
*anyThe item's new data.

Response body

200 OK

{id: "8f02078b-504e-47e2-a177-e6605e3b96e5"
createdAt: "2026-09-23T21:08:25.050Z"
updatedAt: "2026-09-23T21:08:25.050Z"
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: "254969a6-d3d6-4a21-926f-fbe79fe23a55"
displayName: "Sample Display Name"
}
}

Response headers

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

2026-09-22