Search Deal Context — NL answer over deal memory
Ask a natural-language question about one or more authorized deals. The service runs an internal retrieval agent over the resolved deal scope’s observations and source artifacts (call transcripts, emails, notes) and returns a synthesized, citation-backed answer.
Integrator notes:
- Authorized deal set. Pass
deal_idsfor a single or explicit multi-deal search. Omitdeal_idsto search all visible deals in the API key’s organization. Every explicit id must belong to the organization and be visible; otherwise404(cross-org existence is never revealed). Nouser_idis needed. - v1 compatibility. Deprecated
deal_idis accepted as an alias for onedeal_idsentry. - Budget. Omit
budget_modefor the standardmediumpath. Useinstantonly with exactly onedeal_idsentry. Public direct calls accept onlyinstant,medium, andhigh; larger eval modes require an internal queue/eval path. - Read-only. No deal, CRM, or artifact data is modified (the run skips the interactive deal-state regeneration).
- Grounded output.
answeris synthesized fromcitations[]; artifact citations carryobservation_id,artifact_id, and a verbatimsource_quotewhen available, while structured-data citations identify CRM/deal-state/SQL support. Source gaps and caveats are carried in the answer text rather than separate runtime diagnostics.
Authorizations
API key passed as Bearer token (e.g. "Bearer your-api-key")
Body
The natural-language question to answer.
"What did the buyer say about pricing?"
Optional opportunity ids to scope the answer to. Omit to search all visible organization deals.
2500Deprecated v1 alias for a single deal. Prefer deal_ids.
"00000000-0000-0000-0000-000000000000"
Search depth preset for public direct calls. instant is only valid with exactly one deal_ids entry.
instant, medium, high Response
A synthesized, citation-backed answer for the resolved deal scope.
The synthesized natural-language answer, grounded in the citations.
Non-null when the answer names concrete source gaps or caveats.
Evidence the answer is grounded in, in support order.
Deduped manifest of artifacts referenced by artifact citations.
Single resolved deal id when the request resolved to one deal; null for multi-deal or all-visible searches.
How the bounded search loop ended.
final_answer, fallback_final, timeout Server-side wall-clock for the run, in milliseconds.

