puter.kv.remove()
Remove values from an existing key by path. Paths can target nested fields and array elements.
Syntax
puter.kv.remove(key, ...paths)
Parameters
key (String) (required)
The key to remove values from.
paths (String[]) (required)
One or more paths to remove (for example, "profile.bio").
Paths support dot notation, array indexes at any level ([0], items[0], or some.path[1].to.value), and quoted property names (["key.with.dots"]). An empty path ("") deletes the whole entry, as puter.kv.del() does, and resolves to null. Use non-negative integer indexes in brackets to address arrays. Removing an array element shifts later elements down by one index. A path may chain at most 31 levels; a deeper one rejects with bad_request. Quoted names can't be empty. All of a call's paths go into one write, so a call fits at most 1,500 path segments, and fewer when it has many paths or long ones; split larger changes across calls. See Rate Limits and Quotas.
Return value
Returns a Promise that resolves to the updated value stored at key. An expired key resolves to null.
Errors
A rejection carries an Error with a stable code:
| Code | Meaning |
|---|---|
arguments_required |
Called with no paths at all. |
paths_invalid |
Paths were not provided as separate string arguments. |
key_undefined |
No key was given. |
key_too_large |
The key is over the 1 KB limit. |
bad_request |
A malformed path (including an empty quoted name such as [""]), a path nested over 31 levels, two paths that overlap (including the same path twice) or conflict (one treats a shared step as a list index, the other as a field name), or more or longer paths than one write can apply (see Rate Limits and Quotas). |
forbidden |
Called with optConfig.appUuid for another app's data without permission, or the entry is private to that app. |
subject_does_not_exist |
optConfig.appUuid names an app that doesn't exist. |
too_many_requests |
The rate limit was exceeded. See Rate Limits and Quotas. |
Examples
Remove nested fields from an object
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
(async () => {
await puter.kv.set('profile', { name: 'Puter', stats: { score: 10, level: 2 } });
const updated = await puter.kv.remove('profile', 'stats.score');
puter.print(`Updated profile: ${JSON.stringify(updated)}`);
})();
</script>
</body>
</html>