puter.kv.update()
Websites Puter Apps Node.js Workers
Update one or more paths within the value stored at a key. You can update nested fields without overwriting the entire value.
Syntax
puter.kv.update(key, pathAndValueMap)
puter.kv.update(key, pathAndValueMap, ttl)
puter.kv.update({ key, pathAndValueMap, ttl })
Parameters
key (String) (required)
The key to update.
pathAndValueMap (Object) (required)
An object where each key is a dot-separated path (for example, "profile.name") and each value is the new value for that path.
ttl (Number) (optional)
Time-to-live for the key, in seconds.
Return value
Returns a Promise that resolves to the updated value stored at key.
Examples
Update nested fields and refresh the TTL
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
(async () => {
await puter.kv.set('profile', { name: 'Puter', stats: { score: 10 } });
const updated = await puter.kv.update(
'profile',
{ 'stats.score': 11, 'name': 'Puter Smith' },
3600
);
puter.print(`Updated profile: ${JSON.stringify(updated)}`);
})();
</script>
</body>
</html>