replaceReferences( )


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Replaces current references with references in the specified property.

The replaceReferences() method returns a Promise that resolves when the item's current references in the specified property are removed and references to the referenced items are added in their place. The Promise is rejected if the current user does not have update permissions for the collection.

Note: The replaceReferences() method is not supported for single-item collections.

Permissions
Write Data Items
Learn more about app permissions.
Method Declaration
Copy
Method Parameters
dataCollectionIdstringRequired

ID of the collection that contains the referring item.


fieldstringRequired

Field to replaces the references in.


referringItemunionRequired

Referring item or referring item's ID.


referencedItemunionRequired

Referenced item, referenced item's ID, an array of referenced items, or an array of referenced item IDs.


optionsWixDataOptions

Options to use when processing this operation.

Did this help?