Vector reference
Upsert + similarity search routed to the cheapest healthy vector provider.
Endpoints
| Method | Path | Scope | Description |
|---|---|---|---|
| POST | /dashboard/vector/indexes | vector:write | Create an index. |
| POST | /v1/vector/indexes/{name}/upsert | vector:write | Upsert points. |
| POST | /v1/vector/indexes/{name}/query | vector:read | Query by raw vector. |
| POST | /v1/vector/indexes/{name}/query/text | vector:read | Query by text (embedded server-side). |
Quickstart
curl -X POST https://api.valienz.io/v1/vector/indexes/product-search/query/text \
-H "Authorization: Bearer $VALIENZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "red running shoes",
"topK": 5
}'Errors
| Code | HTTP | Description | Resolution |
|---|---|---|---|
| E_INDEX_DIM_MISMATCH | 400 | Point dimension does not match index. | Match the index dimension exactly or upsert into a different index. |