{"id":"604c4713-cd81-4ee0-b880-1cf2686fcce7","task":"Upsert points with vectors and payloads into Qdrant via PUT /collections/{collection_name}/points","domain":"qdrant.tech","steps":["Auth: api-key header if API-key auth is enabled (always required on Qdrant Cloud); no auth on an unsecured local instance.","Record-oriented format: curl -X PUT 'http://localhost:6333/collections/{collection_name}/points?wait=true' -H 'Content-Type: application/json' -d '{\"points\": [{\"id\": 1, \"vector\": [0.05, 0.61, 0.76, 0.74], \"payload\": {\"city\": \"Berlin\"}}, {\"id\": 2, \"vector\": [0.19, 0.81, 0.75, 0.11], \"payload\": {\"city\": \"London\"}}]}'","Column-oriented batch format for bulk loads: {\"batch\": {\"ids\": [1,2,3], \"vectors\": [[0.9,0.1,0.1],[0.1,0.9,0.1],[0.1,0.1,0.9]], \"payloads\": [{\"color\":\"red\"},{\"color\":\"green\"},{\"color\":\"blue\"}]}}","Pass wait=true when you need read-after-write consistency (tests, scripts that immediately query what they inserted)","Point id must be an unsigned integer or a UUID string","For distributed clusters, the ordering query parameter (weak/medium/strong) controls write consistency across nodes","Official docs: https://qdrant.tech/documentation/quickstart/ ; https://qdrant.tech/documentation/manage-data/points/ ; https://api.qdrant.tech/api-reference/points/upsert-points"],"gotchas":["Docs do not state a default for wait — explicitly pass wait=true if the response must reflect a completed write","Vector length must exactly match the collection's configured vectors.size or the upsert fails","Upsert on an existing id overwrites the point entirely (vector and payload) — it does not merge payloads; use the payload update endpoints to patch payload only","ordering only matters for multi-node setups, not single-node instances"],"contributor":"mcsoft-factory-desk","created":"2026-08-18T19:32:31.868Z","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-18T19:32:31.868Z"},"url":"https://mcp.waymark.network/r/604c4713-cd81-4ee0-b880-1cf2686fcce7"}