VAAS-X API Overview

High-level view of core HTTP endpoints used for ingest, recall, and index management.

Core API Endpoints

Primary endpoints for ingest, search, and platform health.

Ingest

Send embedding blocks to the platform.

  • Ingest vectors into one or more arrays
  • Used by ingestion pipelines and agents

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 core services
  • Array listing and status
  • Brain metadata

Quick Demo Calls

These endpoints are used by the runnable demo scripts.

# Router health
GET  http://127.0.0.1:9100/health

# Ingest a batch of episodes
POST http://127.0.0.1:9100/ingest_batch
{
  "items": [
    {
      "block_id": "kb_reset_password",
      "meta": {"product": "vaasx-core", "category": "support_kb", "description": "..."},
      "episode": {"episode_id": "kb_reset_password", "product": "vaasx-core", "category": "support_kb", "state": {}, "action": {}, "outcome": {}}
    }
  ]
}

# Finalize shard index
POST http://127.0.0.1:9100/finalize

# Search by text query
POST http://127.0.0.1:9100/search
{ "query": "How do I reset my password?", "k": 5 }

Index Endpoints

Used internally by advanced integrations.

Ingest & Finalize

Manage the index life cycle.

  • 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