Hybrid Search

Three search modes, one endpoint

Search modes

ModeDescriptionBest for
hybrid (default)Combines FTS + vector, weighted 60/40General purpose
ftsFull-text search using tsvector indexesExact keywords
vectorSemantic similarity using cosine distanceConceptual matches

Examples

# Hybrid search (default)
curl -s "https://api.telepathine.ai/v1/search?q=auth+decision&mode=hybrid" \
  -H "Authorization: Bearer $TELEPATHINE_API_KEY"

# FTS-only
curl -s "https://api.telepathine.ai/v1/search?q=PostgreSQL&mode=fts" \
  -H "Authorization: Bearer $TELEPATHINE_API_KEY"

# Vector search
curl -s "https://api.telepathine.ai/v1/search?q=how+did+we+handle+auth&mode=vector" \
  -H "Authorization: Bearer $TELEPATHINE_API_KEY"

Specialized endpoints

  • GET /v1/timeline — Chronological feed
  • GET /v1/decisions — All decision-type observations
  • GET /v1/changes — All change-type observations