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_ids for a single or explicit multi-deal search. Omit deal_ids to search all visible deals in the API key’s organization. Every explicit id must belong to the organization and be visible; otherwise 404 (cross-org existence is never revealed). No user_id is needed.
v1 compatibility. Deprecated deal_id is accepted as an alias for one deal_ids entry.
Budget. Omit budget_mode for the standard medium path. Use instant only with exactly one deal_ids entry. Public direct calls accept only instant, medium, and high; 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.answer is synthesized from citations[]; artifact citations carry observation_id, artifact_id, and a verbatim source_quote when 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.
POST
/
api
/
v1
/
agentic-search
/
deal-context
Search Deal Context — NL answer over deal memory
curl --request POST \
--url https://findtempo.co/api/v1/agentic-search/deal-context \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"question": "What did the buyer say about pricing?",
"deal_ids": [
"00000000-0000-0000-0000-000000000000"
],
"deal_id": "00000000-0000-0000-0000-000000000000",
"budget_mode": "medium"
}
'
import requests
url = "https://findtempo.co/api/v1/agentic-search/deal-context"
payload = {
"question": "What did the buyer say about pricing?",
"deal_ids": ["00000000-0000-0000-0000-000000000000"],
"deal_id": "00000000-0000-0000-0000-000000000000",
"budget_mode": "medium"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
Server-side wall-clock for the run, in milliseconds.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tempo","colors":{"primary":"#F7471B","light":"#F7471B","dark":"#D63A10"},"logo":{"light":"https://mintcdn.com/temposystemsinc/9v4VmwA3dLoxMgMm/logo/full-light.png?fit=max\u0026auto=format\u0026n=9v4VmwA3dLoxMgMm\u0026q=85\u0026s=e39b38feb688af101649ecc94c7435ec","dark":"https://mintcdn.com/temposystemsinc/DcyfIO8ort0D4mJX/logo/full-dark.png?fit=max\u0026auto=format\u0026n=DcyfIO8ort0D4mJX\u0026q=85\u0026s=057b55f8710f1035b305f8c061cde045"},"favicon":"https://mintcdn.com/temposystemsinc/OrQk_rMunkWbwYnN/favicon.png?fit=max\u0026auto=format\u0026n=OrQk_rMunkWbwYnN\u0026q=85\u0026s=57a2c8b150fe1cfdc0a2b1f52755c48e","background":{"color":{"light":"#F2EEE6","dark":"#2C2A24"}},"navbar":{},"footer":{},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"temposystemsinc","hasAudioNarration":false,"actualSubdomain":"temposystemsinc","customDomains":["docs.findtempo.co"],"gitSource":{"type":"github","owner":"tempo-systems","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af60489f6a89a055440dd32","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"For admins","count":29},{"language":"default","tag":"For developers","count":19},{"language":"default","tag":"REST API","count":16},{"language":"default","tag":"Connect your context","count":11},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Context sources","count":10},{"language":"default","tag":"For sellers","count":9},{"language":"default","tag":"Help","count":8},{"language":"default","tag":"Build","count":7},{"language":"default","tag":"Public Read Tools","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/agentic-search/search-deal-context-—-nl-answer-over-deal-memory","slug":"/api-reference/agentic-search/search-deal-context-—-nl-answer-over-deal-memory","pageMetadata":{"title":"Search Deal Context — NL answer over deal memory","description":"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.\n\nIntegrator notes:\n- **Authorized deal set.** Pass `deal_ids` for a single or explicit multi-deal search. Omit `deal_ids` to search all visible deals in the API key's organization. Every explicit id must belong to the organization and be visible; otherwise `404` (cross-org existence is never revealed). No `user_id` is needed.\n- **v1 compatibility.** Deprecated `deal_id` is accepted as an alias for one `deal_ids` entry.\n- **Budget.** Omit `budget_mode` for the standard `medium` path. Use `instant` only with exactly one `deal_ids` entry. Public direct calls accept only `instant`, `medium`, and `high`; larger eval modes require an internal queue/eval path.\n- **Read-only.** No deal, CRM, or artifact data is modified (the run skips the interactive deal-state regeneration).\n- **Grounded output.** `answer` is synthesized from `citations[]`; artifact citations carry `observation_id`, `artifact_id`, and a verbatim `source_quote` when 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.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/agentic-search/deal-context","href":"/api-reference/agentic-search/search-deal-context-—-nl-answer-over-deal-memory","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"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.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Integrator notes:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"Authorized deal set.\"\n }), \" Pass \", _jsx(_components.code, {\n children: \"deal_ids\"\n }), \" for a single or explicit multi-deal search. Omit \", _jsx(_components.code, {\n children: \"deal_ids\"\n }), \" to search all visible deals in the API key’s organization. Every explicit id must belong to the organization and be visible; otherwise \", _jsx(_components.code, {\n children: \"404\"\n }), \" (cross-org existence is never revealed). No \", _jsx(_components.code, {\n children: \"user_id\"\n }), \" is needed.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"v1 compatibility.\"\n }), \" Deprecated \", _jsx(_components.code, {\n children: \"deal_id\"\n }), \" is accepted as an alias for one \", _jsx(_components.code, {\n children: \"deal_ids\"\n }), \" entry.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"Budget.\"\n }), \" Omit \", _jsx(_components.code, {\n children: \"budget_mode\"\n }), \" for the standard \", _jsx(_components.code, {\n children: \"medium\"\n }), \" path. Use \", _jsx(_components.code, {\n children: \"instant\"\n }), \" only with exactly one \", _jsx(_components.code, {\n children: \"deal_ids\"\n }), \" entry. Public direct calls accept only \", _jsx(_components.code, {\n children: \"instant\"\n }), \", \", _jsx(_components.code, {\n children: \"medium\"\n }), \", and \", _jsx(_components.code, {\n children: \"high\"\n }), \"; larger eval modes require an internal queue/eval path.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"Read-only.\"\n }), \" No deal, CRM, or artifact data is modified (the run skips the interactive deal-state regeneration).\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"Grounded output.\"\n }), \" \", _jsx(_components.code, {\n children: \"answer\"\n }), \" is synthesized from \", _jsx(_components.code, {\n children: \"citations[]\"\n }), \"; artifact citations carry \", _jsx(_components.code, {\n children: \"observation_id\"\n }), \", \", _jsx(_components.code, {\n children: \"artifact_id\"\n }), \", and a verbatim \", _jsx(_components.code, {\n children: \"source_quote\"\n }), \" when 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.\"]\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Search Deal Context — NL answer over deal memory","description":"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.\n\nIntegrator notes:\n- **Authorized deal set.** Pass `deal_ids` for a single or explicit multi-deal search. Omit `deal_ids` to search all visible deals in the API key's organization. Every explicit id must belong to the organization and be visible; otherwise `404` (cross-org existence is never revealed). No `user_id` is needed.\n- **v1 compatibility.** Deprecated `deal_id` is accepted as an alias for one `deal_ids` entry.\n- **Budget.** Omit `budget_mode` for the standard `medium` path. Use `instant` only with exactly one `deal_ids` entry. Public direct calls accept only `instant`, `medium`, and `high`; larger eval modes require an internal queue/eval path.\n- **Read-only.** No deal, CRM, or artifact data is modified (the run skips the interactive deal-state regeneration).\n- **Grounded output.** `answer` is synthesized from `citations[]`; artifact citations carry `observation_id`, `artifact_id`, and a verbatim `source_quote` when 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.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/agentic-search/deal-context","href":"/api-reference/agentic-search/search-deal-context-—-nl-answer-over-deal-memory","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"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.\n\nIntegrator notes:\n- **Authorized deal set.** Pass `deal_ids` for a single or explicit multi-deal search. Omit `deal_ids` to search all visible deals in the API key's organization. Every explicit id must belong to the organization and be visible; otherwise `404` (cross-org existence is never revealed). No `user_id` is needed.\n- **v1 compatibility.** Deprecated `deal_id` is accepted as an alias for one `deal_ids` entry.\n- **Budget.** Omit `budget_mode` for the standard `medium` path. Use `instant` only with exactly one `deal_ids` entry. Public direct calls accept only `instant`, `medium`, and `high`; larger eval modes require an internal queue/eval path.\n- **Read-only.** No deal, CRM, or artifact data is modified (the run skips the interactive deal-state regeneration).\n- **Grounded output.** `answer` is synthesized from `citations[]`; artifact citations carry `observation_id`, `artifact_id`, and a verbatim `source_quote` when 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.","operationId":"AgenticSearchController_searchDealContext_v1","parameters":[],"requestBody":"c0b3a83f-4d3c-47e6-a269-51dd3b0c628a","responses":{"200":"87c68fc9-024c-44b6-9590-da8567aa752b","400":"daae34ef-ee3f-4f9c-a5cc-4579a5d65370","401":"a5e1aee7-7c6e-4a23-b068-aaa5d7d62e11","404":"2f7f6c9a-643f-4b17-86de-df6bd66b2c71"},"security":["995bec88-ac7e-4b4f-8857-5e4d3c434f5b"],"summary":"Search Deal Context — NL answer over deal memory","tags":["Agentic Search"],"method":"post","type":"path","servers":["c912bc9f-c82d-4590-9bdf-167f3cb24415"],"path":"/api/v1/agentic-search/deal-context","baseUrlOptions":["https://findtempo.co"],"title":"Search Deal Context — NL answer over deal memory","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"type":"string","description":"The natural-language question to answer.","example":"What did the buyer say about pricing?","isRequired":true,"uniqueKey":"question","typeLabel":"string"},"deal_ids":{"type":"array","maxItems":2500,"description":"Optional opportunity ids to scope the answer to. Omit to search all visible organization deals.","items":{"type":"string","uniqueKey":"deal_ids.items.[INDEX]","typeLabel":"string"},"example":["00000000-0000-0000-0000-000000000000"],"uniqueKey":"deal_ids","typeLabel":"string[]"},"deal_id":{"type":"string","deprecated":true,"description":"Deprecated v1 alias for a single deal. Prefer deal_ids.","example":"00000000-0000-0000-0000-000000000000","uniqueKey":"deal_id","typeLabel":"string"},"budget_mode":{"type":"string","enum":["instant","medium","high"],"default":"medium","description":"Search depth preset for public direct calls. instant is only valid with exactly one deal_ids entry.","uniqueKey":"budget_mode","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"question":"What did the buyer say about pricing?","deal_ids":["00000000-0000-0000-0000-000000000000"],"deal_id":"00000000-0000-0000-0000-000000000000","budget_mode":"medium"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"87c68fc9-024c-44b6-9590-da8567aa752b":{"description":"A synthesized, citation-backed answer for the resolved deal scope.","content":{"application/json":{"schema":{"type":"object","required":["answer","missing_context","citations","source_artifacts","deal_id","stop_reason","elapsed_ms"],"properties":{"answer":{"type":"string","description":"The synthesized natural-language answer, grounded in the citations.","isRequired":true,"uniqueKey":"answer","typeLabel":"string"},"missing_context":{"oneOf":[{"type":"string","description":"Non-null when the answer names concrete source gaps or caveats.","isRequired":true,"uniqueKey":"missing_context.oneOf.0","typeLabel":"string"},{"type":"null","description":"Non-null when the answer names concrete source gaps or caveats.","isRequired":true,"uniqueKey":"missing_context.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"missing_context","typeLabel":"string | null"},"citations":{"type":"array","description":"Evidence the answer is grounded in, in support order.","items":{"type":"object","properties":{"kind":{"type":"string","enum":["artifact","structured_data"],"uniqueKey":"citations.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"observation_id":{"oneOf":[{"type":"string","description":"Observation backing this citation, if any.","uniqueKey":"citations.items.[INDEX].observation_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Observation backing this citation, if any.","uniqueKey":"citations.items.[INDEX].observation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].observation_id","typeLabel":"string | null"},"deal_id":{"oneOf":[{"type":"string","description":"Deal id for the cited evidence when the citation can be tied to a deal.","uniqueKey":"citations.items.[INDEX].deal_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deal id for the cited evidence when the citation can be tied to a deal.","uniqueKey":"citations.items.[INDEX].deal_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].deal_id","typeLabel":"string | null"},"deal_name":{"oneOf":[{"type":"string","description":"Deal name for citation navigation when available.","uniqueKey":"citations.items.[INDEX].deal_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deal name for citation navigation when available.","uniqueKey":"citations.items.[INDEX].deal_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].deal_name","typeLabel":"string | null"},"account_id":{"oneOf":[{"type":"string","description":"Account id for the cited deal when available.","uniqueKey":"citations.items.[INDEX].account_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Account id for the cited deal when available.","uniqueKey":"citations.items.[INDEX].account_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].account_id","typeLabel":"string | null"},"account_name":{"oneOf":[{"type":"string","description":"Account name for citation navigation when available.","uniqueKey":"citations.items.[INDEX].account_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Account name for citation navigation when available.","uniqueKey":"citations.items.[INDEX].account_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].account_name","typeLabel":"string | null"},"artifact_id":{"oneOf":[{"type":"string","description":"Source artifact (transcript/email/note) the quote came from. Use with a retrieval endpoint to fetch the full artifact.","uniqueKey":"citations.items.[INDEX].artifact_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Source artifact (transcript/email/note) the quote came from. Use with a retrieval endpoint to fetch the full artifact.","uniqueKey":"citations.items.[INDEX].artifact_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].artifact_id","typeLabel":"string | null"},"artifact_title":{"oneOf":[{"type":"string","description":"Display title of the cited source artifact.","uniqueKey":"citations.items.[INDEX].artifact_title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Display title of the cited source artifact.","uniqueKey":"citations.items.[INDEX].artifact_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].artifact_title","typeLabel":"string | null"},"artifact_type":{"oneOf":[{"type":"string","description":"Document or artifact type for navigation and filtering.","uniqueKey":"citations.items.[INDEX].artifact_type.oneOf.0","typeLabel":"string"},{"type":"null","description":"Document or artifact type for navigation and filtering.","uniqueKey":"citations.items.[INDEX].artifact_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].artifact_type","typeLabel":"string | null"},"artifact_source":{"oneOf":[{"type":"string","description":"Source system or channel that produced the cited artifact.","uniqueKey":"citations.items.[INDEX].artifact_source.oneOf.0","typeLabel":"string"},{"type":"null","description":"Source system or channel that produced the cited artifact.","uniqueKey":"citations.items.[INDEX].artifact_source.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].artifact_source","typeLabel":"string | null"},"artifact_summary":{"oneOf":[{"type":"string","description":"Short artifact summary when available.","uniqueKey":"citations.items.[INDEX].artifact_summary.oneOf.0","typeLabel":"string"},{"type":"null","description":"Short artifact summary when available.","uniqueKey":"citations.items.[INDEX].artifact_summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].artifact_summary","typeLabel":"string | null"},"artifact_occurred_at":{"oneOf":[{"type":"string","description":"When the cited artifact occurred, as an ISO timestamp when available.","uniqueKey":"citations.items.[INDEX].artifact_occurred_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the cited artifact occurred, as an ISO timestamp when available.","uniqueKey":"citations.items.[INDEX].artifact_occurred_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].artifact_occurred_at","typeLabel":"string | null"},"source_quote":{"oneOf":[{"type":"string","description":"Verbatim excerpt from the source artifact.","uniqueKey":"citations.items.[INDEX].source_quote.oneOf.0","typeLabel":"string"},{"type":"null","description":"Verbatim excerpt from the source artifact.","uniqueKey":"citations.items.[INDEX].source_quote.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].source_quote","typeLabel":"string | null"},"source_refs":{"type":"array","description":"Structured anchors into the source (line/offset/section/speaker) for precise attribution.","items":{"type":"object","uniqueKey":"citations.items.[INDEX].source_refs.items.[INDEX]","typeLabel":"object"},"uniqueKey":"citations.items.[INDEX].source_refs","typeLabel":"object[]"},"observation_text":{"type":"string","description":"The agent-extracted observation in plain language.","uniqueKey":"citations.items.[INDEX].observation_text","typeLabel":"string"},"structured_data":{"oneOf":[{"type":"object","description":"Structured CRM, deal-state, or SQL support when the citation is not tied to a source artifact.","uniqueKey":"citations.items.[INDEX].structured_data.oneOf.0","typeLabel":"object"},{"type":"null","description":"Structured CRM, deal-state, or SQL support when the citation is not tied to a source artifact.","uniqueKey":"citations.items.[INDEX].structured_data.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].structured_data","typeLabel":"object | null"}},"uniqueKey":"citations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"citations","typeLabel":"object[]"},"source_artifacts":{"type":"array","description":"Deduped manifest of artifacts referenced by artifact citations.","items":{"type":"object","properties":{"artifact_id":{"type":"string","uniqueKey":"source_artifacts.items.[INDEX].artifact_id","typeLabel":"string"},"title":{"oneOf":[{"type":"string","uniqueKey":"source_artifacts.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"source_artifacts.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_artifacts.items.[INDEX].title","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"source_artifacts.items.[INDEX].type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"source_artifacts.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_artifacts.items.[INDEX].type","typeLabel":"string | null"},"source":{"oneOf":[{"type":"string","uniqueKey":"source_artifacts.items.[INDEX].source.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"source_artifacts.items.[INDEX].source.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_artifacts.items.[INDEX].source","typeLabel":"string | null"},"occurred_at":{"oneOf":[{"type":"string","uniqueKey":"source_artifacts.items.[INDEX].occurred_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"source_artifacts.items.[INDEX].occurred_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_artifacts.items.[INDEX].occurred_at","typeLabel":"string | null"},"summary":{"oneOf":[{"type":"string","uniqueKey":"source_artifacts.items.[INDEX].summary.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"source_artifacts.items.[INDEX].summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_artifacts.items.[INDEX].summary","typeLabel":"string | null"}},"uniqueKey":"source_artifacts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"source_artifacts","typeLabel":"object[]"},"deal_id":{"oneOf":[{"type":"string","description":"Single resolved deal id when the request resolved to one deal; null for multi-deal or all-visible searches.","isRequired":true,"uniqueKey":"deal_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Single resolved deal id when the request resolved to one deal; null for multi-deal or all-visible searches.","isRequired":true,"uniqueKey":"deal_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deal_id","typeLabel":"string | null"},"stop_reason":{"type":"string","enum":["final_answer","fallback_final","timeout"],"description":"How the bounded search loop ended.","isRequired":true,"uniqueKey":"stop_reason","typeLabel":"enum\u003cstring>"},"elapsed_ms":{"type":"number","description":"Server-side wall-clock for the run, in milliseconds.","isRequired":true,"uniqueKey":"elapsed_ms","typeLabel":"number"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"answer":"\u003cstring>","missing_context":"\u003cstring>","citations":[{"kind":"artifact","observation_id":"\u003cstring>","deal_id":"\u003cstring>","deal_name":"\u003cstring>","account_id":"\u003cstring>","account_name":"\u003cstring>","artifact_id":"\u003cstring>","artifact_title":"\u003cstring>","artifact_type":"\u003cstring>","artifact_source":"\u003cstring>","artifact_summary":"\u003cstring>","artifact_occurred_at":"\u003cstring>","source_quote":"\u003cstring>","source_refs":[{}],"observation_text":"\u003cstring>","structured_data":{}}],"source_artifacts":[{"artifact_id":"\u003cstring>","title":"\u003cstring>","type":"\u003cstring>","source":"\u003cstring>","occurred_at":"\u003cstring>","summary":"\u003cstring>"}],"deal_id":"\u003cstring>","stop_reason":"final_answer","elapsed_ms":123}}},"exampleType":"generated"}},"exampleType":"generated"},"daae34ef-ee3f-4f9c-a5cc-4579a5d65370":{"description":"Invalid request body (missing/blank `question` or malformed `deal_ids`).","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a5e1aee7-7c6e-4a23-b068-aaa5d7d62e11":{"description":"Missing or invalid API key.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2f7f6c9a-643f-4b17-86de-df6bd66b2c71":{"description":"One or more requested deal ids are not readable by the API key’s organization, or no visible organization deals were available when `deal_ids` was omitted. Returned for unknown ids, deals in another organization, and non-visible deals (cross-org existence is never revealed).","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"995bec88-ac7e-4b4f-8857-5e4d3c434f5b":{"api-key":{"type":"http","scheme":"bearer","description":"Your organization API key. Paste the key itself — the \"Bearer \" prefix is added for you.","scopes":[],"schemeName":"api-key"}}},"servers":{"c912bc9f-c82d-4590-9bdf-167f3cb24415":{"url":"https://findtempo.co","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your organization API key. Paste the key itself — the \"Bearer \" prefix is added for you.","scopes":[],"schemeName":"api-key"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your organization API key. Paste the key itself — the \"Bearer \" prefix is added for you.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"api-key","name":"Authorization"}],"title":"api-key"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"temposystemsinc","siteName":"Tempo","title":"Search Deal Context — NL answer over deal memory - Tempo","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T15:12:14.587Z","originalFileLocation":"api-reference/agentic-search/search-deal-context-—-nl-answer-over-deal-memory.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Ask a natural-language question about one or more authorized deals. The service runs an internal retrieval agent over the resolved deal scope\u0026#x27;s observations and source artifacts (call transcripts, emails, notes) and returns a synthesized, citation-backed answer. Integrator notes: - Authorized deal set. Pass deal_ids for a single or explicit multi-deal search. Omit deal_ids to search all visible deals in the API key\u0026#x27;s organization. Every explicit id must belong to the organization and be visible; otherwise 404 (cross-org existence is never revealed). No user_id is needed. - v1 compatibility. Deprecated deal_id is accepted as an alias for one deal_ids entry. - Budget. Omit budget_mode for the standard medium path. Use instant only with exactly one deal_ids entry. Public direct calls accept only instant, medium, and high; 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. answer is synthesized from citations[]; artifact citations carry observation_id, artifact_id, and a verbatim source_quote when 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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tempo\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/temposystemsinc/P6BG7s0TSYOb7maI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/temposystemsinc/P6BG7s0TSYOb7maI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/temposystemsinc/P6BG7s0TSYOb7maI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/temposystemsinc/P6BG7s0TSYOb7maI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/temposystemsinc/P6BG7s0TSYOb7maI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/temposystemsinc/P6BG7s0TSYOb7maI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/temposystemsinc/P6BG7s0TSYOb7maI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/temposystemsinc/P6BG7s0TSYOb7maI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/temposystemsinc/P6BG7s0TSYOb7maI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search Deal Context — NL answer over deal memory - Tempo\">\u003cmeta data-mint-head property=\"og:description\" content=\"Ask a natural-language question about one or more authorized deals. The service runs an internal retrieval agent over the resolved deal scope\u0026#x27;s observations and source artifacts (call transcripts, emails, notes) and returns a synthesized, citation-backed answer. Integrator notes: - Authorized deal set. Pass deal_ids for a single or explicit multi-deal search. Omit deal_ids to search all visible deals in the API key\u0026#x27;s organization. Every explicit id must belong to the organization and be visible; otherwise 404 (cross-org existence is never revealed). No user_id is needed. - v1 compatibility. Deprecated deal_id is accepted as an alias for one deal_ids entry. - Budget. Omit budget_mode for the standard medium path. Use instant only with exactly one deal_ids entry. Public direct calls accept only instant, medium, and high; 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. answer is synthesized from citations[]; artifact citations carry observation_id, artifact_id, and a verbatim source_quote when 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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tempo\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.findtempo.co/api-reference/agentic-search/search-deal-context-—-nl-answer-over-deal-memory\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://temposystemsinc.mintlify.site/_mintlify/api/og/v2?division=Agentic+Search\u0026amp;title=Search+Deal+Context+%E2%80%94+NL+answer+over+deal+memory\u0026amp;description=Ask+a+natural-language+question+about+one+or+more+authorized+deals.+The+service+runs+an+internal+retrieval+agent+over+the+resolved+deal+scope%27s+observations+and\u0026amp;theme=18827604e69eca8ed6971441\u0026amp;signature=d29278276b3de105c5508a49652a9a04fa77a7f5a1a14939ea101e1ce03f0234\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Search Deal Context — NL answer over deal memory - Tempo\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Ask a natural-language question about one or more authorized deals. The service runs an internal retrieval agent over the resolved deal scope\u0026#x27;s observations and source artifacts (call transcripts, emails, notes) and returns a synthesized, citation-backed answer. Integrator notes: - Authorized deal set. Pass deal_ids for a single or explicit multi-deal search. Omit deal_ids to search all visible deals in the API key\u0026#x27;s organization. Every explicit id must belong to the organization and be visible; otherwise 404 (cross-org existence is never revealed). No user_id is needed. - v1 compatibility. Deprecated deal_id is accepted as an alias for one deal_ids entry. - Budget. Omit budget_mode for the standard medium path. Use instant only with exactly one deal_ids entry. Public direct calls accept only instant, medium, and high; 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. answer is synthesized from citations[]; artifact citations carry observation_id, artifact_id, and a verbatim source_quote when 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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://temposystemsinc.mintlify.site/_mintlify/api/og/v2?division=Agentic+Search\u0026amp;title=Search+Deal+Context+%E2%80%94+NL+answer+over+deal+memory\u0026amp;description=Ask+a+natural-language+question+about+one+or+more+authorized+deals.+The+service+runs+an+internal+retrieval+agent+over+the+resolved+deal+scope%27s+observations+and\u0026amp;theme=18827604e69eca8ed6971441\u0026amp;signature=d29278276b3de105c5508a49652a9a04fa77a7f5a1a14939ea101e1ce03f0234\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/temposystemsinc/P6BG7s0TSYOb7maI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tempo\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F7471B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.findtempo.co/api-reference/agentic-search/search-deal-context-—-nl-answer-over-deal-memory\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agentic-search/search-deal-context-%E2%80%94-nl-answer-over-deal-memory.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.findtempo.co/#organization\",\"name\":\"Tempo\",\"url\":\"https://docs.findtempo.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/temposystemsinc/9v4VmwA3dLoxMgMm/logo/full-light.png?fit=max\u0026auto=format\u0026n=9v4VmwA3dLoxMgMm\u0026q=85\u0026s=e39b38feb688af101649ecc94c7435ec\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.findtempo.co#website\",\"name\":\"Tempo\",\"url\":\"https://docs.findtempo.co\",\"publisher\":{\"@id\":\"https://docs.findtempo.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.findtempo.co/api-reference/agentic-search/search-deal-context-%E2%80%94-nl-answer-over-deal-memory#webpage\",\"url\":\"https://docs.findtempo.co/api-reference/agentic-search/search-deal-context-%E2%80%94-nl-answer-over-deal-memory\",\"name\":\"Search Deal Context — NL answer over deal memory\",\"description\":\"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_ids for a single or explicit multi-deal search. Omit deal_ids to search all visible deals in the API key's organization. Every explicit id must belong to the organization and be visible; otherwise 404 (cross-org existence is never revealed). No user_id is needed. - v1 compatibility. Deprecated deal_id is accepted as an alias for one deal_ids entry. - Budget. Omit budget_mode for the standard medium path. Use instant only with exactly one deal_ids entry. Public direct calls accept only instant, medium, and high; 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. answer is synthesized from citations[]; artifact citations carry observation_id, artifact_id, and a verbatim source_quote when 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.\",\"dateModified\":\"2026-11-06T15:12:14.587Z\",\"isPartOf\":{\"@id\":\"https://docs.findtempo.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.findtempo.co/api-reference/agentic-search/search-deal-context-%E2%80%94-nl-answer-over-deal-memory#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.findtempo.co/api-reference/agentic-search/search-deal-context-%E2%80%94-nl-answer-over-deal-memory#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://docs.findtempo.co/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search Deal Context — NL answer over deal memory\",\"item\":\"https://docs.findtempo.co/api-reference/agentic-search/search-deal-context-%E2%80%94-nl-answer-over-deal-memory\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.findtempo.co/api-reference/agentic-search/search-deal-context-%E2%80%94-nl-answer-over-deal-memory#apireference\",\"headline\":\"Search Deal Context — NL answer over deal memory\",\"name\":\"Search Deal Context — NL answer over deal memory\",\"description\":\"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_ids for a single or explicit multi-deal search. Omit deal_ids to search all visible deals in the API key's organization. Every explicit id must belong to the organization and be visible; otherwise 404 (cross-org existence is never revealed). No user_id is needed. - v1 compatibility. Deprecated deal_id is accepted as an alias for one deal_ids entry. - Budget. Omit budget_mode for the standard medium path. Use instant only with exactly one deal_ids entry. Public direct calls accept only instant, medium, and high; 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. answer is synthesized from citations[]; artifact citations carry observation_id, artifact_id, and a verbatim source_quote when 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.\",\"url\":\"https://docs.findtempo.co/api-reference/agentic-search/search-deal-context-%E2%80%94-nl-answer-over-deal-memory\",\"mainEntityOfPage\":{\"@id\":\"https://docs.findtempo.co/api-reference/agentic-search/search-deal-context-%E2%80%94-nl-answer-over-deal-memory#webpage\"},\"dateModified\":\"2026-11-06T15:12:14.587Z\",\"publisher\":{\"@id\":\"https://docs.findtempo.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.findtempo.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tempo\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tempo\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/agentic-search/search-deal-context-%E2%80%94-nl-answer-over-deal-memory.md","siteName":"Tempo","nav":{"global":null,"tabs":[{"tab":"For sellers","pages":[{"title":"For sellers","href":""}]},{"tab":"For admins","pages":[{"title":"For admins","href":"/admin/setup"}]},{"tab":"For developers","groups":[{"group":"Getting Started","pages":[{"title":"Build on Tempo","sidebarTitle":"Overview","href":"/developers"},{"title":"MCP toolsets","href":"/developers/toolsets"}]},{"group":"MCP","pages":[{"title":"MCP tool reference","href":"/developers/mcp-tools"}]},{"group":"REST API","pages":[{"title":"REST API","sidebarTitle":"Introduction","href":"/api-reference/introduction"},{"group":"Public Read Tools","expanded":false,"pages":[{"title":"Get API principal session context","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/session-context","href":"/api-reference/public-read-tools/get-api-principal-session-context"},{"title":"List visible organization deals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/deals","href":"/api-reference/public-read-tools/list-visible-organization-deals"},{"title":"Get current deal state","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/deals/{dealId}/state","href":"/api-reference/public-read-tools/get-current-deal-state"},{"title":"List visible organization action items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/action-items","href":"/api-reference/public-read-tools/list-visible-organization-action-items"},{"title":"List API principal meetings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/meetings","href":"/api-reference/public-read-tools/list-api-principal-meetings"},{"title":"Get organization sales process overview","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/sales-process","href":"/api-reference/public-read-tools/get-organization-sales-process-overview"}]},{"group":"Query","expanded":false,"pages":[{"title":"Describe all queryable entities + the users you can scope to","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/query/describe","href":"/api-reference/query/describe-all-queryable-entities-+-the-users-you-can-scope-to"},{"title":"Describe one entity (typed field catalog incl. EAV virtual columns)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/query/describe/{entity}","href":"/api-reference/query/describe-one-entity-typed-field-catalog-incl-eav-virtual-columns"},{"title":"Search an entity: filter to matching IDs (+ optional preview rows)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/query/{entity}","href":"/api-reference/query/search-an-entity:-filter-to-matching-ids-+-optional-preview-rows"},{"title":"Aggregate an entity: group-by + measures (counts/sums/etc.)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/query/{entity}/aggregate","href":"/api-reference/query/aggregate-an-entity:-group-by-+-measures-countssumsetc"},{"title":"Fetch entity rows by IDs, with optional relational expand","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/query/{entity}/fetch","href":"/api-reference/query/fetch-entity-rows-by-ids-with-optional-relational-expand"}]},{"group":"Agentic Search","expanded":false,"pages":[{"title":"Search Deal Context — NL answer over deal memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/agentic-search/deal-context","href":"/api-reference/agentic-search/search-deal-context-—-nl-answer-over-deal-memory"}]},{"group":"Deal updates","expanded":false,"pages":[{"title":"List CRM field updates Tempo generated for visible organization deals","description":"Lists opportunity field updates Tempo proposed or wrote from source evidence, with the same filters and payload as the MCP list_deal_updates tool. Defaults match MCP: pending updates on open, non-renewal deals touched in the last 30 days, no-op proposals suppressed. Pass status=approved to read updates already applied to the CRM, deal_state=all to include closed deals, and max_days_since_update to widen the window. Comma-separated values are accepted for update_ids, field_ids, deal_types, and stages. Pending proposals are reviewed and approved in the Tempo app; this route never writes to the CRM.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/deal-updates","href":"/api-reference/public-read-tools/list-crm-field-updates-tempo-generated-for-visible-organization-deals"}]},{"group":"Themes","expanded":false,"pages":[{"title":"List recurring themes or topics across organization deals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/themes","href":"/api-reference/public-read-tools/list-recurring-themes-or-topics-across-organization-deals"},{"title":"Inspect one theme or topic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/themes/{id}","href":"/api-reference/public-read-tools/inspect-one-theme-or-topic"}]}]}]},{"tab":"Help","pages":[{"title":"Help","href":"/support"}]}]},"basePath":"","title":"Search Deal Context — NL answer over deal memory - Tempo","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}