Upsert Qdrant points
qdrant_points_upsertInsert or replace points in a Qdrant collection using vectors or text plus payloads, with conditional insert-only, update-only, and filtered write modes.
Instructions
Insert or replace points (id + vector or text + payload) in a collection.
`vector` matches the collection's vector config: a plain list for a
single unnamed vector; a list of lists for an unnamed multivector;
or a dict keyed by vector name for named vectors, where each value
is a dense list, a multivector, or a sparse vector
(`{"indices": [...], "values": [...]}`). Give `text` instead of `vector`
to have it embedded with every model the collection declares (see
`qdrant_collection_create`'s `text_model`) and stored in its text field
— one text is one point, nothing is split. A text longer than the model
reads (128 tokens, ~500 characters, for the multilingual MiniLM) is
refused rather than silently cut: split it into several points. Needs
the `embeddings` extra.
`update_mode` makes the write conditional: `insert_only` never
overwrites an existing id, `update_only` never creates a new one
(default `upsert` does both). `update_filter` only overwrites existing
points whose current payload matches the filter; ids that don't exist
yet are inserted regardless (verified). `wait=false`
returns before the write is applied.
Fails with a clear error if the collection doesn't exist.
Example: {"collection_name": "docs", "points": [
{"id": 1, "vector": [0.1, 0.2, 0.3, 0.4], "payload": {"city": "ny"}}
]}
Example (text): {"collection_name": "notes", "points": [
{"id": 1, "text": "Grants for young people's housing", "payload": {"year": 2026}}
]}
Example (named dense + sparse): {"collection_name": "docs", "points": [
{"id": 1, "vector": {"dense": [0.1, 0.2, 0.3, 0.4],
"sparse": {"indices": [1, 7], "values": [0.5, 0.2]}}}
]}
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"collection_name": "<collection_name>",
"points": "<points>"
},
"name": "qdrant_points_upsert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | ||
| points | Yes | ||
| update_mode | No | ||
| update_filter | No | ||
| collection_name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| operation_id | No | Sequential number of the operation |