POST a prompt, get back an answer with sources woven in. Ask runs a full Heidi turn: memory recall, tools, reasoning. It is the same brain the chat uses, over plain JSON, gated by the ask scope.
Ask is the front door for scripts and backends: customer-facing tools, internal bots, report generators, anything that needs a grounded answer instead of a raw model call.
Because it runs the agent path, confirmation gating applies to anything side-effecting the turn tries to do.