Points are the core data structure in Qdrant, consisting of a vector, optional payload, and unique ID. Use these endpoints to insert, retrieve, update, and delete points.
Upsert Points
Insert or update points in a collection. If a point with the given ID already exists, it will be overwritten.
curl -X PUT 'http://localhost:6333/collections/{collection_name}/points' \
-H 'Content-Type: application/json' \
-d '{
"points": [
{
"id": 1,
"vector": [0.19, 0.81, 0.75, 0.11],
"payload": {"city": "Berlin", "price": 1.99}
},
{
"id": 2,
"vector": [0.36, 0.55, 0.47, 0.94],
"payload": {"city": "London", "price": 2.99}
}
]
}'
Name of the collection to update
If true, wait for changes to actually happen. Default is true.
Define ordering guarantees: weak, medium, or strong
Timeout for the operation in seconds
List of points to upsertUnique identifier for the point. Can be an integer or UUID string.
Vector data. Can be a single vector array, multi-vector array, or named vectors object.
Optional payload data associated with the point
Update status: acknowledged or completed
Get Point
Retrieve full information about a single point by its ID.
curl -X GET 'http://localhost:6333/collections/{collection_name}/points/{id}'
Name of the collection to retrieve from
ID of the point to retrieve
Read consistency level: majority, quorum, or all
Get Multiple Points
Retrieve multiple points by their IDs.
curl -X POST 'http://localhost:6333/collections/{collection_name}/points' \
-H 'Content-Type: application/json' \
-d '{
"ids": [1, 2, 3]
}'
Name of the collection to retrieve from
Request timeout in seconds
Array of point IDs to retrieve
Whether to return payload. Can be true, false, array of field names, or include/exclude object.
Whether to return vectors. Can be true, false, or array of vector names.
Array of point objects with id, vector, and payload
Delete Points
Delete points from a collection by ID or filter.
curl -X POST 'http://localhost:6333/collections/{collection_name}/points/delete' \
-H 'Content-Type: application/json' \
-d '{
"points": [1, 2, 3]
}'
curl -X POST 'http://localhost:6333/collections/{collection_name}/points/delete' \
-H 'Content-Type: application/json' \
-d '{
"filter": {
"must": [
{"key": "city", "match": {"value": "London"}}
]
}
}'
Name of the collection to delete from
If true, wait for changes to actually happen
Define ordering guarantees for the operation
Timeout for the operation in seconds
Array of point IDs to delete
Filter conditions to select points for deletionAll conditions must match
At least one condition must match
All conditions must NOT match
curl -X POST 'http://localhost:6333/collections/{collection_name}/points/scroll' \
-H 'Content-Type: application/json' \
-d '{
"limit": 10,
"with_payload": true,
"with_vector": false
}'
Name of the collection to retrieve from
Request timeout in seconds
Start from this point ID. Omit to start from the beginning.
Maximum number of points to return. Default is 10.
Filter conditions to select points
Whether to return payload
Whether to return vectors
Payload field to order results by
Offset for the next page, or null if this is the last page
Set Payload
Set or update payload values for specific points.
curl -X POST 'http://localhost:6333/collections/{collection_name}/points/payload' \
-H 'Content-Type: application/json' \
-d '{
"payload": {
"property1": "value1",
"property2": "value2"
},
"points": [1, 2, 3]
}'
If true, wait for changes to actually happen
Define ordering guarantees for the operation
Timeout for the operation in seconds
Array of point IDs to update
Filter to select points for update
Overwrite Payload
Replace the entire payload of points with a new one.
curl -X PUT 'http://localhost:6333/collections/{collection_name}/points/payload' \
-H 'Content-Type: application/json' \
-d '{
"payload": {
"new_field": "new_value"
},
"points": [1, 2, 3]
}'
Delete Payload
Delete specific payload keys from points.
curl -X POST 'http://localhost:6333/collections/{collection_name}/points/payload/delete' \
-H 'Content-Type: application/json' \
-d '{
"keys": ["property1", "property2"],
"points": [1, 2, 3]
}'
If true, wait for changes to actually happen
Define ordering guarantees for the operation
Timeout for the operation in seconds
Array of payload keys to delete
Array of point IDs to update
Filter to select points for update
Clear Payload
Remove all payload from specified points.
curl -X POST 'http://localhost:6333/collections/{collection_name}/points/payload/clear' \
-H 'Content-Type: application/json' \
-d '{
"points": [1, 2, 3]
}'
If true, wait for changes to actually happen
Define ordering guarantees for the operation
Timeout for the operation in seconds
Array of point IDs to clear
Filter to select points for clearing
Update Vectors
Update specific named vectors on points while keeping other vectors intact.
curl -X PUT 'http://localhost:6333/collections/{collection_name}/points/vectors' \
-H 'Content-Type: application/json' \
-d '{
"points": [
{
"id": 1,
"vector": {
"image": [0.1, 0.2, 0.3, 0.4]
}
}
]
}'
If true, wait for changes to actually happen
Define ordering guarantees for the operation
Timeout for the operation in seconds
Array of points with vectors to update Delete Vectors
Delete specific named vectors from points.
curl -X POST 'http://localhost:6333/collections/{collection_name}/points/vectors/delete' \
-H 'Content-Type: application/json' \
-d '{
"vector": ["image", "audio"],
"points": [1, 2, 3]
}'
If true, wait for changes to actually happen
Define ordering guarantees for the operation
Timeout for the operation in seconds
Array of vector names to delete
Batch Update
Apply multiple update operations for points, vectors, and payloads in a single request.
curl -X POST 'http://localhost:6333/collections/{collection_name}/points/batch' \
-H 'Content-Type: application/json' \
-d '{
"operations": [
{
"upsert": {
"points": [
{"id": 1, "vector": [0.1, 0.2], "payload": {"city": "Berlin"}}
]
}
},
{
"delete": {
"points": [2, 3]
}
}
]
}'
If true, wait for changes to actually happen
Define ordering guarantees for the operation
Timeout for the operation in seconds
Array of operations to execute. Each operation can be: upsert, delete, set_payload, overwrite_payload, delete_payload, clear_payload, update_vectors, or delete_vectors.
Array of update results for each operation
