Sign in

v2

latestOpenAPI 3.1.02026-08-0382170235.8 KB
search
search

Semantic search over facts

Execute semantic search using RAG retrieval strategy.

Ranking formula: combined_score = (similarity × 0.7) + (pot_score × 0.3)

Results are ordered by combined score descending.

Filtering:

  • min_pot_score: Pre-filter by minimum certainty score
  • filters.domain: Post-filter by exact domain match
  • filters.level: Post-filter by POT Index level(s) (OR logic)
  • filters.tags: Post-filter by tags (AND logic - must have ALL)
post/pots/{pot_id}/search

Path parameters

pot_idstring required

POT identifier (UUID or slug)

POT identifier (UUID or slug)

Request body

querystring required

Natural language search query

top_kinteger

Maximum number of results to return

min_pot_scorenumber

Minimum POT Index threshold for results

include_contentboolean

Include full fact content in results (set false for compact response)

Example request

{
  "filters": {
    "domain": "architecture"
  },
  "min_pot_score": 0.4,
  "query": "How does POT Index propagate through edges?",
  "top_k": 10
}

Response

Successful search

object required