Upload

curl -X POST "http://localhost:8080/upload" \
  -H "Content-Type: application/json" \
  -d '{
    "store_mode": "text",
    "embedding_model": "BAAI/bge-small-en-v1.5",
    "items": [
      {
        "id": "doc-1",
        "text": "Hello world",
        "vector": [0.01, -0.02, "... 384 floats ..."]
      }
    ]
  }'

{
  "status": "success",
  "message": "Items uploaded successfully.",
  "total": 1,
  "dimension": 384,
  "store_mode": "text"
}

{
  "status": "failure",
  "message": "Item limit exceeded: max 10000, current 10000, requested 1 new items.",
  "items": 10000,
  "max_items": 10000,
  "requested_new": 1
}

POST

upload

curl -X POST "http://localhost:8080/upload" \
  -H "Content-Type: application/json" \
  -d '{
    "store_mode": "text",
    "embedding_model": "BAAI/bge-small-en-v1.5",
    "items": [
      {
        "id": "doc-1",
        "text": "Hello world",
        "vector": [0.01, -0.02, "... 384 floats ..."]
      }
    ]
  }'

{
  "status": "success",
  "message": "Items uploaded successfully.",
  "total": 1,
  "dimension": 384,
  "store_mode": "text"
}

{
  "status": "failure",
  "message": "Item limit exceeded: max 10000, current 10000, requested 1 new items.",
  "items": 10000,
  "max_items": 10000,
  "requested_new": 1
}

Overview

Upload or replace items keyed by id. Re-uploading an existing id updates the embedding and does not consume additional quota. On the first upload to an empty store, store_mode is required. Dimension and mode are locked afterward.

string

Required when the store is empty: "text" or "vector".

string

Optional for text stores. Defaults to BAAI/bge-small-en-v1.5.

array

required

Non-empty array of item objects.

Each item object:

string

required

Item id. Alias: item_id.

array

required

Float embedding matching the store dimension (384 for text mode).

string

Optional text stored with the item and returned in search results.

curl -X POST "http://localhost:8080/upload" \
  -H "Content-Type: application/json" \
  -d '{
    "store_mode": "text",
    "embedding_model": "BAAI/bge-small-en-v1.5",
    "items": [
      {
        "id": "doc-1",
        "text": "Hello world",
        "vector": [0.01, -0.02, "... 384 floats ..."]
      }
    ]
  }'

{
  "status": "success",
  "message": "Items uploaded successfully.",
  "total": 1,
  "dimension": 384,
  "store_mode": "text"
}

{
  "status": "failure",
  "message": "Item limit exceeded: max 10000, current 10000, requested 1 new items.",
  "items": 10000,
  "max_items": 10000,
  "requested_new": 1
}

System

Search

AI Generation

Data Operations

Delete

Overview

​Overview

​Related

Overview

Related