POST

Bulk Insert Data Item References


Inserts one or more references in the specified fields of items in a collection.

This method adds one or more references to a collection. Each new reference in the dataItemReferences field specifies a referring item's ID, the field in which to insert the reference, and the ID of the referenced item.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage All Data Resources
Manage Data Items
Write Data Items
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/wix-data/v2/bulk/items/insert-references

Body Params
dataCollectionIdstringRequiredmaxLength 256

ID of the collection containing the referring items.


dataItemReferencesArray <DataItemReference>RequiredmaxItems 1000

References to insert.


returnEntityboolean

Whether to return the inserted data item references. When true, the results objects contain a dataItemReference field.

Default: false

Response Object
resultsArray <BulkDataItemReferenceResult>

Information about the inserted references.


bulkActionMetadataBulkActionMetadata

Bulk action metadata.

Request
cURL
Response
JSON
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?