This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Inserts a reference in the specified property.
The insertReference()
method returns a Promise that resolves when a
reference to the referenced item(s) is added to the referring item in the
specified property. The Promise is rejected if the current user does not
have update permissions for the collection.
Notes:
insertReference()
method only applies to multi-reference fields.insertReference()
method is not supported for Single Item
Collections.
ID of the collection that contains the referring item.
Field to insert the reference into.
Referring item or referring item's ID.
Referenced item, referenced item's ID, an array of referenced items, or an array of referenced item IDs.
Options to use when processing this operation.