Patch Data Item

Patches an item in a collection.

Call this method when you need a partial update and want fields that aren't mentioned in the request to stay unchanged. Patch requests are also the right place to use fieldModifications actions such as SET_FIELD for a direct replacement and INCREMENT_FIELD for arithmetic changes. For different behavior, you can call:

• Update Data Item to replace the full payload rather than patch part of it.
• Save Data Item for upsert behavior, meaning to create if the item doesn't exist and update if it does.

This method modifies the specified item's existing data. Unlike Update Data Item, only the fields specified in the request are modified. Data that isn't explicitly modified remains unchanged.

To patch an item, specify its ID, the ID of the collection that contains it, and the modifications you want to apply. If an item is found in the specified collection with the specified ID, that item is patched. If the collection doesn't contain an item with that ID, the request fails.