Skip to main content
POST
/
knowledge-stores
/
{store_id}
/
search
from hx import Client

client = Client()

results = client.knowledge.search(
    store_id="ks-your-store-id",
    query="What is Hexel Studio?",
    top_k=5
)

{
  "results": [
    {
      "chunk_id": "chunk_abc123",
      "document_id": "doc_xyz789",
      "text": "Hexel Studio is a platform for building AI applications...",
      "score": 0.92,
      "metadata": {
        "source": "docs"
      }
    }
  ],
  "count": 1,
  "query": "What is Hexel Studio?",
  "knowledge_store_id": "ks-your-store-id",
  "latency_ms": 45
}
Search for relevant documents in a knowledge store using semantic search.
​
store_id
string
required
Knowledge Store ID
​
query
string
required
Search query text (1-10000 characters)
​
top_k
integer
default:10
Number of results to return (1-100)
​
score_threshold
number
Minimum similarity score threshold (0.0-1.0)
​
metadata_filter
object
Filter results by metadata fields
from hx import Client

client = Client()

results = client.knowledge.search(
    store_id="ks-your-store-id",
    query="What is Hexel Studio?",
    top_k=5
)

{
  "results": [
    {
      "chunk_id": "chunk_abc123",
      "document_id": "doc_xyz789",
      "text": "Hexel Studio is a platform for building AI applications...",
      "score": 0.92,
      "metadata": {
        "source": "docs"
      }
    }
  ],
  "count": 1,
  "query": "What is Hexel Studio?",
  "knowledge_store_id": "ks-your-store-id",
  "latency_ms": 45
}