Upsert points

from actian_vectorai_client import VectorAIClient, PointStruct
import random

with VectorAIClient("localhost:6574") as client:
    # Batch upsert multiple points
    points = [
        PointStruct(
            id=i,
            vector=[random.gauss(0, 1) for _ in range(32)],
            payload={"category": ["A", "B", "C"][i % 3], "value": i * 10}
        )
        for i in range(1, 21)
    ]
    result = client.points.upsert("my_collection", points)
    print(f"✓ Upserted {len(points)} points")

{
  "usage": {
    "hardware": null
  },
  "time": 0.058295368,
  "status": "ok",
  "result": {
    "operation_id": 0,
    "status": "Completed"
  }
}

{
  "status": {
    "error": "Collection `my_collection` doesn't exist!"
  },
  "time": 123
}

PUT

collections

{collection_name}

points

from actian_vectorai_client import VectorAIClient, PointStruct
import random

with VectorAIClient("localhost:6574") as client:
    # Batch upsert multiple points
    points = [
        PointStruct(
            id=i,
            vector=[random.gauss(0, 1) for _ in range(32)],
            payload={"category": ["A", "B", "C"][i % 3], "value": i * 10}
        )
        for i in range(1, 21)
    ]
    result = client.points.upsert("my_collection", points)
    print(f"✓ Upserted {len(points)} points")

{
  "usage": {
    "hardware": null
  },
  "time": 0.058295368,
  "status": "ok",
  "result": {
    "operation_id": 0,
    "status": "Completed"
  }
}

{
  "status": {
    "error": "Collection `my_collection` doesn't exist!"
  },
  "time": 123
}

Authorizations

Authorization

string

header

required

Admin JWT or access token for authenticating requests to VectorAI DB.

Path Parameters

collection_name

string

required

The name of the collection to upsert points into.

Query Parameters

wait

boolean

default:true

If true, the request blocks until all points are indexed. If false, returns immediately and indexing continues in the background. Defaults to true.

Example:

true

Body

application/json

points

object[]

required

Array of point objects to insert or update.

Show child attributes

Response

Points upserted successfully

usage

object

Resource usage information for this request.

Show child attributes

time

number<double>

Time spent to process this request, in seconds.

Example:

0.058295368

status

string

Operation status. Returns ok on success.

Example:

"ok"

result

object

Operation result containing the status of the upsert.

Show child attributes

Delete collection Get single point

⌘I

REST API

gRPC API

Authorizations

Path Parameters

Query Parameters

Body

Response