Updates an item in a collection.
The update()
function returns a Promise that resolves to the updated
item from the specified collection. The Promise is rejected if the
current user does not have update permissions for the collection.
Calling the update()
function triggers the beforeUpdate()
and afterUpdate()
hooks if they have been defined.
The update()
function compares the _id
property of the specified
item with the _id
property values of the items in the specified
collection. If an item in the collection has that _id
value, update()
replaces the item's property values with the ones in the specified item.
If the existing item had properties with values and those properties were not
included in the specified item, the values in those properties are lost. The
item's _updatedDate
property is also updated to the current date.
Any valid JavaScript object can be used as a property value. The update()
function maintains the structure of the specified object. For example,
objects that contain nested objects, Arrays, or Arrays with nested objects
are all added to the collection as defined.
Use the options
parameter to run update()
from backend code without
checking for permissions or without its registered hooks.
When updating an item in a collection that has a reference field, set
the value of the reference field to the referenced item's _id
value or
the entire referenced item object.
The maximum size of an item that you can update in a collection is 500kb.
Notes:
_id
property that already exists in the collection.update()
function does not support multi-reference fields. For multi-reference fields, use replaceReferences()
or insertReference()
.update()
will fail and issue an error.
The ID of the collection that contains the item to update.
To find your collectionId, select the Databases tab in the Velo Sidebar. Hover over your collection, click the three dots, and select Edit Settings.
The item to update.
An object containing options to use when processing this operation.