[eggn00dles]

put implies overwriting instead of updating.

upsert is for you insert/update.

[pas]

update already means overwriting.

semantically PUT is exactly upsert.

upsert is update + create if not exists, which is exactly PUT

any update without overwrite is "append" or "extend" (or something else)

[eggn00dles]

append or extend is adding keys without updating existing keys. update can add keys and update existing keys.

put will blow away existing keys if they dont exist in the new payload. which is why it cant be upsert.