For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
CloudGitHub
  • API Reference
      • POSTRetrieve points
      • PUTUpsert points
      • GETRetrieve a point
      • POSTDelete points
      • PUTUpdate vectors
      • POSTDelete vectors
      • POSTSet payload
      • PUTOverwrite payload
      • POSTDelete payload
      • POSTClear payload
      • POSTBatch update points
      • POSTScroll points
      • POSTCount points
LogoLogo
CloudGitHub
API ReferencePoints

Upsert points

PUT
/collections/:collection_name/points
PUT
/collections/:collection_name/points
$curl -X PUT http://localhost:6333/collections/collection_name/points \
>     -H "api-key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "batch": {
>    "ids": [
>      1
>    ],
>    "vectors": {}
>  }
>}'
200Updated
1{
2  "time": 1.1,
3  "status": "string",
4  "result": {
5    "status": "acknowledged",
6    "operation_id": 1
7  }
8}

Performs the insert + update action on specified points. Any point with an existing {id} will be overwritten.

Was this page helpful?
Previous

Retrieve a point

Next
Built with

Authentication

api-keystring
API Key authentication via header

Path parameters

collection_namestringRequired
Name of the collection to update from

Query parameters

waitbooleanOptional
If true, wait for changes to actually happen
orderingenumOptional
define ordering guarantees for the operation
Allowed values:

Request

Operation to perform on points
PointsBatchobjectRequired
OR
PointsListobjectRequired

Response

successful operation
timedouble
Time spent to process this request
statusstring
resultobject