Guide

Weaviate Endpoint

Source

Weaviate endpoints connect Gateway to Weaviate clusters for governed vector search, retrieval, and AI application workflows.

Endpoint Kind

Use weaviate as the endpoint kind when creating this endpoint through the API or dashboard.

What Gateway Uses This Endpoint For

  • Run governed vector search and retrieval operations.
  • Expose semantic search to AI Orchestration and approved tools.
  • Centralize API key handling and audit around retrieval workflows.
  • Combine vector search with SQL, document, and LLM endpoints.

Basic Endpoint Shape

json
{
  "endpoint": "weaviate-prod",
  "kind": "weaviate",
  "config": {
    "read_conn": {
      "url": "https://cluster.weaviate.network",
      "token": "secret"
    }
  }
}

Create it with the endpoint API:

bash
curl -sS -X POST "$EDEN/endpoints" \
  -H "$AUTH_HEADER" \
  -H "Content-Type: application/json" \
  -d '{
  "endpoint": "weaviate-prod",
  "kind": "weaviate",
  "config": {
    "read_conn": {
      "url": "https://cluster.weaviate.network",
      "token": "secret"
    }
  }
}'

Configuration Fields

FieldPurpose
urlWeaviate cluster URL
tokenAPI key or token

Operating Notes

  • Treat collection names and vectorizer configuration as part of the application contract.
  • Scope tokens to the collections Gateway should query or mutate.
  • Monitor latency and result volume for agent-facing retrieval tools.
Help improve Eden Docs

Find something unclear or incomplete? Review the source and propose an update.

View on GitLab Updated August 2, 2026