Endpoints
Retrieve
Policy-scoped hybrid retrieval — returns ranked, scored chunks the caller is allowed to see.
POST/v1/retrieve
Runs a policy-scoped hybrid search and returns the ranked chunks the caller is
allowed to see. This is the primitive under everything: /v1/answer
is retrieve followed by grounded generation.
Request body
Prop
Type
{
"query": "how do I port my existing number?",
"surface": "site_chatbot",
"channel": "chat",
"mode": "accurate",
"topK": 5
}Response
Prop
Type
Each entry of chunks is a Scored:
Prop
Type
{
"chunks": [
{
"id": "chunk:port_faq_2",
"docId": "website/porting",
"text": "To port your number, submit a request in Settings → Numbers…",
"classification": "public",
"sourceSystem": "website",
"score": 0.83,
"via": "fused",
"metadata": { "url": "https://…/porting", "title": "Porting" }
}
],
"decisionId": "dec_9f2c…",
"snapshotId": "snap_v3_10421_b17",
"policyBundleRevision": "pb_2026_07_01",
"mode": "accurate",
"timings": { "embed": 4, "search": 11, "fuse": 2 }
}Try it
POST http://localhost:8080/v1/retrieve
With the public demo key you get public chunks only. Swap in
sa_demo_internal_key to see internal results fuse into the same ranked list.