Ask
Package ask is a plain-language question about your business, answered with real numbers.
Package ask is a plain-language question about your business, answered with real numbers.
| Base URL | https://api.hanzo.ai |
| Operations | 1 |
| Auth | Authorization: Bearer $HANZO_API_KEY |
ask
POST /v1/ask
Ask a grounded question about your own org
Answers a natural-language question about the CALLER'S OWN org, from real figures rather than from the model's memory.
The question is classified to a grounded domain, that domain's read runs IN-PROCESS under the caller's own credentials, and only then is the result narrated. So the figures and their sources are the domain's, resolved before any model call and never altered by one — a wrong answer is a wrong query, never an invention.
Domains: books (the org's ledger) and web (search, news, research, deep). A validated principal is required; the answer is scoped to that principal's org and nothing else.
Request body — application/json
| Field | Type | Required | Description |
|---|---|---|---|
followUps | boolean | — | |
language | string | — | |
maxQueries | integer | — | |
maxSources | integer | — | |
mode | string | — | |
model | string | — | |
q | string | — | |
question | string | — | |
sources | string[] | — | |
stream | boolean | — | |
system | string | — |
How is this guide?