Struct NamespacedClient 

pub struct NamespacedClient<'a> { /* private fields */ }

Implementations

impl<'a> NamespacedClient<'a>

pub async fn upsert(&self, body: &Value) -> Result<UpsertResponse, Error>

Upsert a vector into a namespace. This creates the namespace if it does not yet have any vectors.

Example:

use turbopuffer_client::Client;

let ns = Client::new("secret").namespace("test");

let vectors = serde_json::json!({
  "ids": [1, 2, 3, 4],
  "vectors": [[0.1, 0.1], [0.2, 0.2], [0.3, 0.3], [0.4, 0.4]],
  "attributes": {
    "my-string": ["one", null, "three", "four"],
    "my-uint": [12, null, 84, 39],
    "my-string-array": [["a", "b"], ["b", "d"], [], ["c"]]
  }
});

let res = ns.upsert(&vectors).await.unwrap();

pub async fn query(&self, body: &Value) -> Result<QueryResponse, Error>

Query the namespace for matching vectors.

Example:

use turbopuffer_client::Client;

let ns = Client::new("secret").namespace("test");

let query = serde_json::json!({
  "vector": [0.105, 0.1],
  "distance_metric": "euclidean_squared",
  "top_k": 1,
  "include_vectors": true,
  "include_attributes": ["my-string"],
});

let res = ns.query(&query).await.unwrap();

pub async fn delete(&self) -> Result<DeleteResponse, Error>

Deletes the namespace and all related data.

Example:

use turbopuffer_client::Client;

let ns = Client::new("secret").namespace("test");

let res = ns.delete().await.unwrap();