VAAS-X API Overview

High-level view of router and shard HTTP endpoints used by all verticals.

Router Endpoints

Exposed by the routing service that sits in front of shards.

Ingest

Send embedding blocks to the platform.

  • Ingest vectors into one or more shards
  • Used by ingestion pipelines and products

Search

Query for similar episodes.

  • Vector-based search
  • Text-to-vector search convenience endpoint
  • Top-k result control

Health & Metadata

Monitor and inspect the brain.

  • Health checks for router
  • Shard listing and status
  • Brain metadata

Shard Endpoints

Used internally by the router and advanced integrations.

Ingest & Finalize

Manage the index life cycle on a shard.

  • Ingest batches of vectors
  • Finalize HCI index
  • Clear or delete slots

Search & Data

Query and inspect stored data.

  • Search for nearest neighbors
  • Fetch slots and statistics
  • Support for encrypted vectors