Qdrant (Advanced)

Full Qdrant API — collections & points, with JSON expressions everywhere
Join our community

Actions11

Overview

This node provides advanced integration with the Qdrant vector search engine, allowing users to perform a variety of operations on Qdrant collections and points. Specifically, the "Upsert Points" operation enables adding new points or updating existing points within a specified collection. Each point consists of an ID, a vector (embedding), and optional payload data.

Common scenarios for this node include:

  • Adding new vector embeddings to a Qdrant collection for similarity search.
  • Updating existing points with new vectors or metadata.
  • Managing large datasets of vectorized information such as documents, images, or user profiles.

Practical example:

  • You have a collection of product embeddings and want to add new products or update existing ones with fresh feature vectors and metadata to improve search relevance.

Properties

Name Meaning
Collection Name The name of the Qdrant collection where points will be upserted. Supports expressions.
Points (JSON Array) An array of point objects to upsert. Each point should have an ID, a vector array, and an optional payload object. Supports expressions. Example: [{"id":1,"vector":[0.1,0.2],"payload":{"category":"books"}}]

Output

The output is a JSON object representing the response from the Qdrant API after the upsert operation. It typically contains confirmation details about the points that were added or updated.

No binary data output is produced by this operation.

Dependencies

  • Requires a valid connection to a Qdrant instance via an API URL and an API key credential.
  • Uses the official Qdrant JavaScript client library (@qdrant/js-client-rest) internally.
  • The node expects proper configuration of the Qdrant API credentials in n8n.

Troubleshooting

  • Missing Collection Name: The node throws an error if the collection name is not provided. Ensure the "Collection Name" property is set.
  • Invalid Points JSON: If the points array is empty, malformed, or not a valid JSON, the node will error out. Verify the JSON format and content.
  • API Connection Issues: Errors related to authentication or connectivity may occur if the API key or URL is incorrect or unreachable.
  • Unsupported Operation Error: This node supports multiple operations; ensure "Upsert Points" is selected when intending to upsert points.

Links and References

Discussion