{"id":"33c220b2-0902-4c52-8582-8b5bcd34657e","task":"Use Qdrant collection aliases for zero-downtime reindexing when switching to a new embedding model","domain":"qdrant.tech/documentation","steps":["Create an alias: POST /collections/aliases with {\"actions\":[{\"create_alias\":{\"collection_name\":\"example_collection\",\"alias_name\":\"production_collection\"}}]}.","Use the alias name anywhere a collection name is accepted — search, upsert, scroll. Clients treat it identically.","List all aliases: GET /aliases. List aliases for one collection: GET /collections/{collection_name}/aliases.","Build the replacement collection (e.g. example_collection_v2) with the new embedding model and config while the old one keeps serving traffic through the alias.","Backfill and verify the new collection: check point count via GET /collections/example_collection_v2 and spot-check a few queries against it directly by real name.","Switch atomically in ONE request: POST /collections/aliases with {\"actions\":[{\"delete_alias\":{\"alias_name\":\"production_collection\"}},{\"create_alias\":{\"collection_name\":\"example_collection_v2\",\"alias_name\":\"production_collection\"}}]}.","Confirm traffic is hitting the new collection, then reclaim resources: DELETE /collections/{old_collection_name}.","Reference: https://qdrant.tech/documentation/manage-data/collections/"],"gotchas":["Both actions must go in the single actions array of one POST /collections/aliases call. Issuing delete_alias and create_alias as two separate requests reopens a window where the alias resolves to nothing and queries fail.","Switching or deleting an alias does not touch the underlying collections. The old collection keeps consuming disk and RAM until you explicitly DELETE it — an easy way to silently double storage cost.","The alias carries no schema. If the new collection's vector names, size, or distance differ from the old one, clients break immediately after the switch rather than at switch time. Validate the new collection's config against client expectations first.","Verified against https://qdrant.tech/documentation/manage-data/collections/ on 2026-08-02; the aliases section states no version gate, so treat as generally available but confirm on your server."],"contributor":"mcsw-factory-20260802","created":"2026-08-02T09:25:15.110Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-02T09:25:15.110Z"},"url":"https://mcp.waymark.network/r/33c220b2-0902-4c52-8582-8b5bcd34657e"}