Qdrant icon

Qdrant

Official n8n node to interface with Qdrant - https://qdrant.tech

Payload → Set Payload

AI-generated

Overview

This node operation sets or updates the payload values for specific points within a collection in Qdrant, a vector search engine. It is useful for scenarios where you need to modify metadata or additional information associated with points in a collection, such as updating attributes or tags for search optimization or data enrichment.

Use Case Examples

  1. Updating user profile attributes stored as points in a Qdrant collection.
  2. Setting custom metadata for product vectors in an e-commerce recommendation system.

Properties

Name Meaning
Collection Name Specifies the target collection in which the points reside. The collection can be selected from a list or specified by name.
Payload The JSON object containing the payload values to set for the selected points.
Point IDs A JSON array of point IDs to which the payload will be applied.
Filter A JSON object defining conditions to filter points; only points satisfying these conditions will have their payload set.
Key A string path specifying where in the point's properties the payload should be assigned.
Shard Key A JSON value specifying which shards to search for the points; if not specified, all shards are searched.
Wait Boolean flag indicating whether to wait for the changes to be applied before continuing.
Ordering Defines the ordering guarantees for the operation, with options for weak, medium, or strong consistency.
Request Options Additional request settings such as batching, SSL certificate validation, proxy configuration, and timeout settings.

Output

JSON

  • success - Indicates whether the payload set operation was successful.
  • modifiedCount - Number of points whose payload was modified.
  • details - Additional details or metadata about the operation result.

Dependencies

  • Requires an API key credential for Qdrant REST API access.

Troubleshooting

  • Ensure the collection name is correct and exists in Qdrant to avoid errors related to missing collections.
  • Validate the JSON format of the payload, point IDs, filter, and shard key to prevent malformed request errors.
  • If the operation times out, consider increasing the timeout setting or checking network connectivity.
  • If SSL certificate validation fails and you trust the endpoint, enable the option to ignore SSL issues.
  • Check that the point IDs or filter conditions correctly match existing points to ensure the payload is applied as expected.

Links

Discussion