Skip to main content
POST
/
upload
curl -X POST "http://localhost:8080/upload" \
  -H "Content-Type: application/json" \
  -d '{
    "vectors": [
      {
        "id": "item-1",
        "vector": [0.01, -0.02, "... 1024 floats ..."]
      }
    ]
  }'

{
  "status": "success",
  "message": "Vectors uploaded successfully.",
  "total": 1
}

​
Overview

Upload or replace vectors keyed by id. Re-uploading an existing id updates the embedding and does not consume additional quota.
​
vectors
array
required
Non-empty array of vector objects.
Each vector object:
​
id
string
Item id. Alias: item_id.
​
vector
array
required
Exactly 1024 finite floats.
curl -X POST "http://localhost:8080/upload" \
  -H "Content-Type: application/json" \
  -d '{
    "vectors": [
      {
        "id": "item-1",
        "vector": [0.01, -0.02, "... 1024 floats ..."]
      }
    ]
  }'

{
  "status": "success",
  "message": "Vectors uploaded successfully.",
  "total": 1
}