Overview

Vector existence checking operations provide a lightweight and efficient way to verify whether specific vectors exist in your graph database without retrieving their full data.

These operations support various use cases such as vector data validation, conditional processing, API optimization, and building robust error handling mechanisms.

Check Vector Existence

Check if a vector exists using HEAD: /v1.0/tenants/{tenant-guid}/vectors/{vector-guid}. This endpoint performs a lightweight existence check without returning the vector data, making it ideal for validation and conditional operations.

curl --location --head 'http://localhost:8701/v1.0/tenants/00000000-0000-0000-0000-000000000000/vectors/00000000-0000-0000-0000-000000000000' \
--header 'Authorization: ••••••'

import { LiteGraphSdk } from "litegraphdb";

var api = new LiteGraphSdk(
  "http://localhost:8701/",
  "<Tenant-Guid>",
  "*******"
);

const existsVector = async () => {
  try {
    const data = await api.Vector.exists("<vector-guid>");
    console.log(data, "check data");
  } catch (err) {
    console.log("err:", JSON.stringify(err));
  }
};

import litegraph

sdk = litegraph.configure(
    endpoint="http://localhost:8701",
    tenant_guid="Tenant-Guid",
    access_key="******",
)

def exists_vector():
    exists = litegraph.Vector.exists(guid="vector-guid-1")
    print(exists)

exists_vector()

using LiteGraph;
using LiteGraph.GraphRepositories.Sqlite;

LiteGraphClient liteGraph = new LiteGraphClient(new SqliteGraphRepository("litegraph.db"));
liteGraph.InitializeRepository();
bool exists = liteGraph.Vector.ExistsByGuid(Guid.Parse("<tenant-guid>"),
                                            Guid.Parse("<vector-guid>"));

Response

The API returns different status codes based on vector existence:

200 OK: Vector exists and is accessible
404 Not Found: Vector does not exist