pypi / qdrant-client
qdrant-client
What changed in qdrant-client 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
8 breaking8 deprecations3 new APIs and options7 behavior and defaults47 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initqdrant-client 173 changes
Breaking changes 8
Formula variables reject negative score indices.
The MMR offset is applied to reranked output rather than candidates.
An unmapped StartFrom now raises instead of returning None.
Local mode no longer accepts empty vectors or multivectors.
The add method has been removed; use FastEmbed with upsert instead.
Adds payload storage configuration to create_collection, superseding on_disk_payload.
The query method has been removed; use FastEmbed with query_points instead.
In local mode, values_count bounds must be satisfied by a single value.
Deprecations 8
max_resident_memory_percent has been deprecated.
on_disk_payload has been deprecated in favor of the new payload config.
recommend has been deprecated in favor of query_points.
recommend_batch has been deprecated in favor of query_batch_points.
recommend_groups has been deprecated in favor of query_points_groups.
search has been deprecated in favor of query_points.
search_batch has been deprecated in favor of query_batch_points.
search_groups has been deprecated in favor of query_points_groups.
New APIs and options 3
Requests can use custom headers for tracing.
Named vectors can be created or deleted after creating a collection.
Turboquantization is introduced.
Behavior and default changes 7
Local mode supports FieldCondition.is_empty.
Local mode supports FieldCondition.is_null.
Local mode accepts a bare point ID as a prefetch query.
Local fusion applies root filters afterward and pushes them into prefetch search.
Local mode mirrors the server's token-aware text and phrase matching.
In local mode, the client warns that search_params is ignored instead of silently dropping it.
The server version check runs in a thread to avoid blocking the async client.
Fixes and other changes 47
Fixes timeout handling in the async client.
Collection existence checks reject empty collection names.
An absent CollectionInfo.points_count remains None over gRPC.
cosine_similarity no longer mutates the query in place.
The datetime parse fallback completes only an hour-only UTC offset.
delete_payload now honors nested JSON-path keys.
Fixes sorting mixed-type point IDs in the distance matrix.
Facet boolean and integer values remain distinct.
Geo filters ignore nonnumeric coordinates and reject nonfinite coordinates.
Boolean group-by keys are skipped to match server GroupId semantics.
Local mode updates IDF statistics on deletion and rejects writes to absent points.
Fixes is_integer usage in the local mode formula API.
Local mode makes IsNull array-aware to match server behavior.
Local query parameters are validated.
Local mode uses token-aware matching for MatchAny, matching server behavior.
Rejects min_should min_count values that the server rejects.
MMR tie-breaking now matches core behavior.
Fixes the missing multivector placeholder in local mode.
Fixes local mode matching the wrong points for null and empty-should filters.
Fixes naive datetime handling and exact datetime precision in order_by.
Boolean payload values are skipped during order_by to match server semantics.
Formula PowExpression rejects zero raised to a negative exponent.
Pins keyword index prefix=False round-trip behavior over gRPC.
Fixes score-orientation handling for these query types in local mode.
score_threshold is applied strictly according to server semantics.
Fixes shard key selector usage in update payload methods.
Fixes local single-prefetch behavior.
Local mode isolates sparse vectors at storage boundaries.
Sparse vectors and vector dimensions are validated with raises instead of asserts.
Fixes start_from handling when passed a date object.
An absent UpdateResult.operation_id remains None over gRPC.
Local mode isolates payload values across wildcard targets.
Local mode honors string and non-list Sequence selectors for with_payload and with_vectors.
Local mode honors string and non-list Sequence selectors for with_payload and with_vectors.
Fixes a TypeError when MatchText is applied to a non-string field.
Prevents falsy shard keys from being dropped during conversion.
Fixes embed paths.
Adds limit > 0 rules in local mode.
Fixes filters cross-matching booleans and integers in local mode.
Fixes nested payload handling in local mode.
REST/gRPC conversion preserves proto3 field presence for falsy values.
Fixes local mode set_payload behavior on shared nested objects.
Fixes update vectors in local mode.
Local mode no longer modifies date filters.
Local mode edge cases for geo filters are fixed.
A type hint error is fixed for grpc_uploader with older protobuf versions.
Local mode values counts are fixed for iterables other than lists to match the server.