Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream.
Note: For this search chat endpoint, the stock_id (BBG_ID) can be obtained by referring to the Map Tickers API and using the stock_id value from its response.
POST
/
v2
/
chat
/
sse
Generate a response from the LinqAlpha engine via SSE
Every user-initiated chat is grouped under a conversation. A conversation contains one or more messages generated either by the user or LinqAlpha. Use the conversation_id to track the context of previous interactions.
Specifies the number of top search results to return.
If the value exceeds 50, it will be capped at 50
The number of returned results will be less than or equal to the specified top_k value.
Results are sorted by relevancy in descending order (from highest to lowest).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Linq Alpha API Docs","colors":{"primary":"#1767FE","light":"#1767FE","dark":"#1767FE"},"logo":{"light":"https://mintcdn.com/linqalpha/9BNJqkVKHb4kSYyJ/logo/light.svg?fit=max\u0026auto=format\u0026n=9BNJqkVKHb4kSYyJ\u0026q=85\u0026s=d7dd093386c0527ef6e6c9ef5f8130ad","dark":"https://mintcdn.com/linqalpha/9BNJqkVKHb4kSYyJ/logo/dark.svg?fit=max\u0026auto=format\u0026n=9BNJqkVKHb4kSYyJ\u0026q=85\u0026s=03c8b4a884d6b9c2deb87606bd15f0c7"},"favicon":"https://mintcdn.com/linqalpha/9BNJqkVKHb4kSYyJ/favicon.svg?fit=max\u0026auto=format\u0026n=9BNJqkVKHb4kSYyJ\u0026q=85\u0026s=384de566c2f8fe8b6d627bd19c014f2c","navbar":{"links":[{"href":"mailto:support@linqalpha.com","label":"Support"}]},"footer":{"socials":{"github":"https://github.com/linq-rag","linkedin":"https://www.linkedin.com/company/linqalpha/posts?feedView=all"},"links":[{"header":"Legal","items":[{"label":"AI Disclaimer","href":"https://linqalpha.com/disclaimer"},{"label":"Terms of Use","href":"https://linqalpha.com/terms-of-use"},{"label":"Privacy Policy","href":"https://linqalpha.com/privacy-policy"}]}]},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Website","href":"https://linqalpha.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"linqalpha","hasAudioNarration":false,"actualSubdomain":"linqalpha","customDomains":["docs.linqalpha.com"],"gitSource":{"type":"github","owner":"linq-rag","repo":"linq-public-api","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adbbd2a01ae999ce782ca39","collectionId":"00c88381-983e-45c7-9553-efed77ef87e8","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adbbd2a01ae999ce782ca39"},"feedback":{"thumbs":true,"issues":false,"edits":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adbbd2a01ae999ce782ca39","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Reference","count":53},{"language":"default","tag":"Basic","count":16},{"language":"default","tag":"Briefing","count":9},{"language":"default","tag":"RMS (On request)","count":7},{"language":"default","tag":"Analytics V2","count":6},{"language":"default","tag":"Evaluations","count":4},{"language":"default","tag":"Transcriptions","count":4},{"language":"default","tag":"Meeting Agent","count":3},{"language":"default","tag":"Sync Status","count":3},{"language":"default","tag":"MCP","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/basic/chat_v2","slug":"/api-reference/basic/chat_v2","pageMetadata":{"title":"Chat","openapi":"POST /v2/chat/sse","description":"Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream.\n\n**Note**: For this search chat endpoint, the stock_id (BBG_ID) can be obtained by referring to the [Map Tickers API](https://docs.linqalpha.com/api-reference/basic/map_tickers) and using the `stock_id` value from its response.","href":"/api-reference/basic/chat_v2"},"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 a: \"a\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Note\"\n }), \": For this search chat endpoint, the stock_id (BBG_ID) can be obtained by referring to the \", _jsx(_components.a, {\n href: \"https://docs.linqalpha.com/api-reference/basic/map_tickers\",\n children: \"Map Tickers API\"\n }), \" and using the \", _jsx(_components.code, {\n children: \"stock_id\"\n }), \" value from its response.\"]\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":"Chat","openapi":"POST /v2/chat/sse","description":"Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream.\n\n**Note**: For this search chat endpoint, the stock_id (BBG_ID) can be obtained by referring to the [Map Tickers API](https://docs.linqalpha.com/api-reference/basic/map_tickers) and using the `stock_id` value from its response.","href":"/api-reference/basic/chat_v2"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Generate a response from the LinqAlpha engine via SSE","description":"Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream.\n\n**Note**: For this search chat endpoint, the stock_id (BBG_ID) can be obtained by referring to the [Map Tickers API](https://docs.linqalpha.com/api-reference/basic/map_tickers) and using the `stock_id` value from its response.","requestBody":"e43ac5b8-eebe-436c-b1be-da3134504f5c","responses":{"200":"92c14fd0-8157-420e-a22e-ae9ab05a559f","400":"ecf4961c-44e2-42f0-9d2d-c42209740526","401":"789ca6ee-83e0-4dcb-91a6-6e574f316b07","403":"26fe6195-5605-4482-b984-b1d72de3eb85","500":"48d57ef1-8cab-434e-aa94-cddd3e9f6b5c"},"tags":["Search"],"method":"post","type":"path","servers":["9cdf8e58-8f32-4db6-a144-4d35b9596918"],"security":["8aa7599b-2dcb-4258-a16e-03ea68ad1736"],"path":"/v2/chat/sse","baseUrlOptions":["https://api.linqalpha.com"],"title":"Generate a response from the LinqAlpha engine via SSE","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"A search query","example":"What are the latest updates on AAPL?","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"conversation_id":{"type":"string","format":"uuid","description":"Conversation id (optional)\n\nEvery user-initiated chat is grouped under a conversation. A conversation contains one or more messages generated either by the user or LinqAlpha. Use the conversation_id to track the context of previous interactions.","example":"123e4567-e89b-12d3-a456-426614174000","uniqueKey":"conversation_id","typeLabel":"string\u003cuuid>"},"stock_ids":{"type":"array","items":{"type":"string","uniqueKey":"stock_ids.items.[INDEX]","typeLabel":"string"},"description":"Bloomberg stock IDs (optional)","example":["BBG001S5N8V8"],"uniqueKey":"stock_ids","typeLabel":"string[]"},"tickers":{"type":"array","items":{"type":"string","uniqueKey":"tickers.items.[INDEX]","typeLabel":"string"},"description":"Ticker symbols (optional)","example":["AAPL"],"uniqueKey":"tickers","typeLabel":"string[]"},"external_types":{"type":"array","items":{"type":"string","uniqueKey":"external_types.items.[INDEX]","typeLabel":"string"},"description":"External document types (optional, defaults to [\"transcript\", \"filing\", \"news\", \"ir_slide\"])","default":["transcript","filing","news","ir_slide"],"example":["transcript","filing","news","ir_slide"],"uniqueKey":"external_types","typeLabel":"string[]"},"top_k":{"type":"number","description":"Specifies the number of top search results to return.\nIf the value exceeds 50, it will be capped at 50\nThe number of returned results will be less than or equal to the specified top_k value.\nResults are sorted by relevancy in descending order (from highest to lowest).","example":50,"uniqueKey":"top_k","typeLabel":"number"},"upload_period":{"type":"object","description":"Filter documents by upload date range. At least one of start_time or end_time must be provided.","properties":{"start_time":{"type":"object","description":"Date filter with year, month, and optional day","properties":{"year":{"type":"integer","description":"Year (e.g., 2025)","example":2025,"isRequired":true,"uniqueKey":"upload_period.start_time.year","typeLabel":"integer"},"month":{"type":"integer","description":"Month (1-12)","minimum":1,"maximum":12,"example":1,"isRequired":true,"uniqueKey":"upload_period.start_time.month","typeLabel":"integer"},"day":{"type":"integer","description":"Day of month (1-31, optional)","minimum":1,"maximum":31,"example":15,"uniqueKey":"upload_period.start_time.day","typeLabel":"integer"}},"required":["year","month"],"uniqueKey":"upload_period.start_time","typeLabel":"object"},"end_time":{"type":"object","description":"Date filter with year, month, and optional day","properties":{"year":{"type":"integer","description":"Year (e.g., 2025)","example":2025,"isRequired":true,"uniqueKey":"upload_period.end_time.year","typeLabel":"integer"},"month":{"type":"integer","description":"Month (1-12)","minimum":1,"maximum":12,"example":1,"isRequired":true,"uniqueKey":"upload_period.end_time.month","typeLabel":"integer"},"day":{"type":"integer","description":"Day of month (1-31, optional)","minimum":1,"maximum":31,"example":15,"uniqueKey":"upload_period.end_time.day","typeLabel":"integer"}},"required":["year","month"],"uniqueKey":"upload_period.end_time","typeLabel":"object"}},"example":{"start_time":{"year":2025,"month":1,"day":1},"end_time":{"year":2026,"month":1,"day":17}},"uniqueKey":"upload_period","typeLabel":"object"}},"required":["query"],"uniqueKey":"","typeLabel":"object"},"example":{"query":"What are the latest insights on AAPL performance?","stock_ids":["BBG001S5N8V8"],"tickers":["AAPL"],"external_types":["transcript","filing","news","ir_slide"]},"examples":{"Example":{"title":"Example","value":{"query":"What are the latest insights on AAPL performance?","stock_ids":["BBG001S5N8V8"],"tickers":["AAPL"],"external_types":["transcript","filing","news","ir_slide"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"92c14fd0-8157-420e-a22e-ae9ab05a559f":{"description":"SSE stream response with RMS search results","content":{"text/event-stream":{"schema":{"oneOf":[{"type":"object","description":"Conversation event","required":["event_name","data"],"properties":{"event_name":{"type":"string","enum":["conversation"],"isRequired":true,"uniqueKey":"oneOf.0.event_name","typeLabel":"enum\u003cstring>"},"data":{"type":"object","description":"Event-specific data payload","required":["conversation_id"],"properties":{"conversation_id":{"type":"string","description":"Unique conversation identifier. Use for multi-turn continuation and References API.","isRequired":true,"uniqueKey":"oneOf.0.data.conversation_id","typeLabel":"string"},"message":{"type":"string","description":"Status message (e.g., 'Successfully created a conversation.')","uniqueKey":"oneOf.0.data.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.0.data","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Thinking/reasoning process stream","required":["event_name","data"],"properties":{"event_name":{"type":"string","description":"Type of SSE event","enum":["think"],"isRequired":true,"uniqueKey":"oneOf.1.event_name","typeLabel":"enum\u003cstring>"},"data":{"type":"object","description":"Event-specific data payload","required":["think_piece"],"properties":{"think_piece":{"type":"string","description":"A piece of the thinking/reasoning process (streamed incrementally)","example":"\u003cPLAN_REASONING>","isRequired":true,"uniqueKey":"oneOf.1.data.think_piece","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.data","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","description":"Sub-questions event","required":["event_name","data"],"properties":{"event_name":{"type":"string","description":"Type of SSE event","enum":["sub_questions"],"isRequired":true,"uniqueKey":"oneOf.2.event_name","typeLabel":"enum\u003cstring>"},"data":{"type":"object","description":"Event-specific data payload","required":["sub_questions"],"properties":{"sub_questions":{"type":"array","description":"Sub-questions","items":{"type":"string","description":"Sub-question","uniqueKey":"oneOf.2.data.sub_questions.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"oneOf.2.data.sub_questions","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"oneOf.2.data","typeLabel":"object"}},"uniqueKey":"oneOf.2","typeLabel":"object"},{"type":"object","description":"Stream status event (start/finish)","required":["event_name","data"],"properties":{"event_name":{"type":"string","description":"Type of SSE event","enum":["status"],"isRequired":true,"uniqueKey":"oneOf.3.event_name","typeLabel":"enum\u003cstring>"},"data":{"type":"object","description":"Event-specific data payload","required":["status"],"properties":{"status":{"type":"string","enum":["start","finish"],"description":"Stream status indicator","isRequired":true,"uniqueKey":"oneOf.3.data.status","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"oneOf.3.data","typeLabel":"object"}},"uniqueKey":"oneOf.3","typeLabel":"object"},{"type":"object","description":"Dialogue id streaming event","required":["event_name","data"],"properties":{"event_name":{"type":"string","enum":["dialogue_id"],"isRequired":true,"uniqueKey":"oneOf.4.event_name","typeLabel":"enum\u003cstring>"},"data":{"type":"object","description":"Event-specific data payload","required":["dialogue_id"],"properties":{"dialogue_id":{"type":"string","description":"A unique identifier (UUID) that represents a specific dialogue or message exchange within a chat session. This ID is provided as an event during the chat process, appearing in the stream before any think events.\n\nThe dialogue_id serves to uniquely identify individual dialogue instances within a chat session, enabling precise control over message streaming and interruption. Here, a dialogue is defined as a single question and answer pair - so a single chat_session is composed of a sequence of dialogues.\n\nUnlike using only the chat_session_id, the dialogue_id prevents race conditions that could occur when multiple windows or instances interact with the same chat session simultaneously. ","isRequired":true,"uniqueKey":"oneOf.4.data.dialogue_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.4.data","typeLabel":"object"}},"uniqueKey":"oneOf.4","typeLabel":"object"},{"type":"object","description":"Search result id streaming event","required":["event_name","data"],"properties":{"event_name":{"type":"string","enum":["search_results"],"isRequired":true,"uniqueKey":"oneOf.5.event_name","typeLabel":"enum\u003cstring>"},"data":{"type":"object","description":"Event-specific data payload","required":["chat_message_id"],"properties":{"chat_message_id":{"type":"string","description":"Chat message id (You can retrieve search_results using the chat_message_id through the references API.)","isRequired":true,"uniqueKey":"oneOf.5.data.chat_message_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.5.data","typeLabel":"object"}},"uniqueKey":"oneOf.5","typeLabel":"object"},{"type":"object","description":"Final answer streaming event","required":["event_name","data"],"properties":{"event_name":{"type":"string","description":"Type of SSE event","enum":["answer"],"isRequired":true,"uniqueKey":"oneOf.6.event_name","typeLabel":"enum\u003cstring>"},"data":{"type":"object","description":"Event-specific data payload","required":["answer_piece"],"properties":{"answer_piece":{"type":"string","description":"A piece of the final answer (streamed incrementally). Citations are embedded as [hash] format.","example":"### Executive Summary","isRequired":true,"uniqueKey":"oneOf.6.data.answer_piece","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.6.data","typeLabel":"object"}},"uniqueKey":"oneOf.6","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"conversation_created":{"title":"conversation_created","description":"Conversation creation event - first event in the stream","value":{"event_name":"conversation","data":{"conversation_id":"123e4567-e89b-12d3-a456-426614174000"}}},"think_event":{"title":"think_event","description":"Streamed reasoning/planning process","value":{"event_name":"think","data":{"think_piece":"\u003cPLAN_REASONING>"}}},"sub_questions_event":{"title":"sub_questions_event","description":"Sub-questions generated for the current message","value":{"event_name":"sub_questions","data":{"sub_questions":["What is the latest news about JP morgan equity research asia?","What is the latest news about JP morgan equity research asia?"]}}},"status_event":{"title":"status_event","description":"Indicates stream has completed","value":{"event_name":"status","data":{"status":"finish"}}},"dialogue_id_event":{"title":"dialogue_id_event","description":"Unique identifier for the current dialogue","value":{"event_name":"dialogue_id","data":{"dialogue_id":"123e4567-e89b-12d3-a456-426614174000"}}},"search_results_event":{"title":"search_results_event","description":"Unique identifier for the search results","value":{"event_name":"search_results","data":{"chat_message_id":"123e4567-e89b-12d3-a456-426614174000"}}},"answer_event":{"title":"answer_event","description":"Streamed answer content","value":{"event_name":"answer","data":{"answer_piece":"Based on the latest research..."}}}},"exampleType":"examples"}},"exampleType":"examples"},"ecf4961c-44e2-42f0-9d2d-c42209740526":{"description":"Bad Request - Invalid request parameters or incorrect format.","content":{"application/json":{"schema":{"type":"object","description":"Standard error response wrapper","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Error code indicating the type of error. Common codes:\n- Authentication: `API_KEY_MISSING`, `INVALID_API_KEY`\n- Validation: `INVALID_REQUEST_BODY`, `ORGANIZATION_ID_MISSING`, `TICKERS_MISSING`, `CHAT_MESSAGE_ID_MISSING`, `DOCUMENT_ID_MISSING`\n- Service: `SEARCH_FAIL`, `TTS_FAIL`, `CREATE_CONV_FAIL`, `GET_STOCK_FAIL`, `CREATE_MSG_FAIL`, `ALPHA_COMP_FAIL`, `GET_REF_FAIL`\n- Connectors: `CONNECTOR_LIST_FAIL`, `CONNECTOR_NOT_FOUND`, `CONNECTOR_CREATE_FAIL`, `CONNECTOR_UPDATE_FAIL`, `CONNECTOR_DELETE_FAIL`, `CONNECTOR_TEST_FAIL`\n- Not Found: `NOT_FOUND`\n- Meeting cancellation: `MEETING_NOT_FOUND`, `MEETING_NOT_CANCELABLE`, `MEETING_CANCEL_REASON_REQUIRED`, `MEETING_CANCEL_UNAVAILABLE`, `MEETING_CANCEL_FAIL`\n- Meeting compliance review: `MEETING_NOT_FOUND`, `MEETING_REVIEW_NOT_PERMITTED`, `MEETING_NOT_REVIEWABLE`, `MEETING_REVIEW_UNAVAILABLE`, `MEETING_REVIEW_FAIL`\n- Transcriptions: `TRANSCRIPTION_UPLOAD_FAIL`, `TRANSCRIPTION_SUBMIT_FAIL`, `TRANSCRIPTION_GET_FAIL`, `TRANSCRIPTION_NOT_FOUND`, `TRANSCRIPTION_REQUEST_INVALID`, `TRANSCRIPTION_RESULT_UNAVAILABLE` (503, poll again), `TRANSCRIPTION_SUBMIT_UNAVAILABLE` (503, submit again with the same Idempotency-Key)","example":"INVALID_REQUEST_BODY","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"msg":{"type":"string","description":"Error message (deprecated, use `message` instead)","example":"query is required and must be a string","uniqueKey":"error.msg","typeLabel":"string"},"message":{"type":"string","description":"Error message providing more details about the error","example":"query is required and must be a string","uniqueKey":"error.message","typeLabel":"string"}},"required":["code"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"payload":{"oneOf":[{"description":"Always null for error responses","isRequired":true,"uniqueKey":"payload.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses","type":"null","isRequired":true,"uniqueKey":"payload.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payload","typeLabel":"any | null"}},"required":["error","payload"],"uniqueKey":"","typeLabel":"object"},"examples":{"invalid_upload_period":{"title":"invalid_upload_period","value":{"error":{"code":"INVALID_REQUEST_BODY","message":"upload_period.start_time must be an object with year (integer), month (integer 1-12), and optional day (integer 1-31). Example: {\"year\": 2025, \"month\": 1, \"day\": 1}"},"payload":null}},"missing_query":{"title":"missing_query","value":{"error":{"code":"INVALID_REQUEST_BODY","message":"query is required and must be a string"},"payload":null}}},"exampleType":"examples"}},"exampleType":"examples"},"789ca6ee-83e0-4dcb-91a6-6e574f316b07":{"description":"Unauthorized - Invalid authentication credentials.","content":{"application/json":{"schema":{"type":"object","description":"Standard error response wrapper","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Error code indicating the type of error. Common codes:\n- Authentication: `API_KEY_MISSING`, `INVALID_API_KEY`\n- Validation: `INVALID_REQUEST_BODY`, `ORGANIZATION_ID_MISSING`, `TICKERS_MISSING`, `CHAT_MESSAGE_ID_MISSING`, `DOCUMENT_ID_MISSING`\n- Service: `SEARCH_FAIL`, `TTS_FAIL`, `CREATE_CONV_FAIL`, `GET_STOCK_FAIL`, `CREATE_MSG_FAIL`, `ALPHA_COMP_FAIL`, `GET_REF_FAIL`\n- Connectors: `CONNECTOR_LIST_FAIL`, `CONNECTOR_NOT_FOUND`, `CONNECTOR_CREATE_FAIL`, `CONNECTOR_UPDATE_FAIL`, `CONNECTOR_DELETE_FAIL`, `CONNECTOR_TEST_FAIL`\n- Not Found: `NOT_FOUND`\n- Meeting cancellation: `MEETING_NOT_FOUND`, `MEETING_NOT_CANCELABLE`, `MEETING_CANCEL_REASON_REQUIRED`, `MEETING_CANCEL_UNAVAILABLE`, `MEETING_CANCEL_FAIL`\n- Meeting compliance review: `MEETING_NOT_FOUND`, `MEETING_REVIEW_NOT_PERMITTED`, `MEETING_NOT_REVIEWABLE`, `MEETING_REVIEW_UNAVAILABLE`, `MEETING_REVIEW_FAIL`\n- Transcriptions: `TRANSCRIPTION_UPLOAD_FAIL`, `TRANSCRIPTION_SUBMIT_FAIL`, `TRANSCRIPTION_GET_FAIL`, `TRANSCRIPTION_NOT_FOUND`, `TRANSCRIPTION_REQUEST_INVALID`, `TRANSCRIPTION_RESULT_UNAVAILABLE` (503, poll again), `TRANSCRIPTION_SUBMIT_UNAVAILABLE` (503, submit again with the same Idempotency-Key)","example":"INVALID_REQUEST_BODY","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"msg":{"type":"string","description":"Error message (deprecated, use `message` instead)","example":"query is required and must be a string","uniqueKey":"error.msg","typeLabel":"string"},"message":{"type":"string","description":"Error message providing more details about the error","example":"query is required and must be a string","uniqueKey":"error.message","typeLabel":"string"}},"required":["code"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"payload":{"oneOf":[{"description":"Always null for error responses","isRequired":true,"uniqueKey":"payload.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses","type":"null","isRequired":true,"uniqueKey":"payload.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payload","typeLabel":"any | null"}},"required":["error","payload"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"API_KEY_MISSING","msg":"header does not contain api key","message":"header does not contain api key"},"payload":null},"examples":{"Example":{"title":"Example","value":{"error":{"code":"API_KEY_MISSING","msg":"header does not contain api key","message":"header does not contain api key"},"payload":null}}},"exampleType":"examples"}},"exampleType":"examples"},"26fe6195-5605-4482-b984-b1d72de3eb85":{"description":"ENDPOINT_NOT_ENABLED: the organization's feature limit for this endpoint is set to blocked. Contact LinqAlpha to enable it.","content":{"application/json":{"schema":{"type":"object","description":"Standard error response wrapper","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Error code indicating the type of error. Common codes:\n- Authentication: `API_KEY_MISSING`, `INVALID_API_KEY`\n- Validation: `INVALID_REQUEST_BODY`, `ORGANIZATION_ID_MISSING`, `TICKERS_MISSING`, `CHAT_MESSAGE_ID_MISSING`, `DOCUMENT_ID_MISSING`\n- Service: `SEARCH_FAIL`, `TTS_FAIL`, `CREATE_CONV_FAIL`, `GET_STOCK_FAIL`, `CREATE_MSG_FAIL`, `ALPHA_COMP_FAIL`, `GET_REF_FAIL`\n- Connectors: `CONNECTOR_LIST_FAIL`, `CONNECTOR_NOT_FOUND`, `CONNECTOR_CREATE_FAIL`, `CONNECTOR_UPDATE_FAIL`, `CONNECTOR_DELETE_FAIL`, `CONNECTOR_TEST_FAIL`\n- Not Found: `NOT_FOUND`\n- Meeting cancellation: `MEETING_NOT_FOUND`, `MEETING_NOT_CANCELABLE`, `MEETING_CANCEL_REASON_REQUIRED`, `MEETING_CANCEL_UNAVAILABLE`, `MEETING_CANCEL_FAIL`\n- Meeting compliance review: `MEETING_NOT_FOUND`, `MEETING_REVIEW_NOT_PERMITTED`, `MEETING_NOT_REVIEWABLE`, `MEETING_REVIEW_UNAVAILABLE`, `MEETING_REVIEW_FAIL`\n- Transcriptions: `TRANSCRIPTION_UPLOAD_FAIL`, `TRANSCRIPTION_SUBMIT_FAIL`, `TRANSCRIPTION_GET_FAIL`, `TRANSCRIPTION_NOT_FOUND`, `TRANSCRIPTION_REQUEST_INVALID`, `TRANSCRIPTION_RESULT_UNAVAILABLE` (503, poll again), `TRANSCRIPTION_SUBMIT_UNAVAILABLE` (503, submit again with the same Idempotency-Key)","example":"INVALID_REQUEST_BODY","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"msg":{"type":"string","description":"Error message (deprecated, use `message` instead)","example":"query is required and must be a string","uniqueKey":"error.msg","typeLabel":"string"},"message":{"type":"string","description":"Error message providing more details about the error","example":"query is required and must be a string","uniqueKey":"error.message","typeLabel":"string"}},"required":["code"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"payload":{"oneOf":[{"description":"Always null for error responses","isRequired":true,"uniqueKey":"payload.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses","type":"null","isRequired":true,"uniqueKey":"payload.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payload","typeLabel":"any | null"}},"required":["error","payload"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"ENDPOINT_NOT_ENABLED","msg":"This endpoint is not enabled for your organization (public_api_chat_sse). Contact LinqAlpha to enable it.","message":"This endpoint is not enabled for your organization (public_api_chat_sse). Contact LinqAlpha to enable it."},"payload":null},"examples":{"Example":{"title":"Example","value":{"error":{"code":"ENDPOINT_NOT_ENABLED","msg":"This endpoint is not enabled for your organization (public_api_chat_sse). Contact LinqAlpha to enable it.","message":"This endpoint is not enabled for your organization (public_api_chat_sse). Contact LinqAlpha to enable it."},"payload":null}}},"exampleType":"examples"}},"exampleType":"examples"},"48d57ef1-8cab-434e-aa94-cddd3e9f6b5c":{"description":"Internal Server Error - An unexpected error occurred on the server.","content":{"application/json":{"schema":{"type":"object","description":"Standard error response wrapper","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Error code indicating the type of error. Common codes:\n- Authentication: `API_KEY_MISSING`, `INVALID_API_KEY`\n- Validation: `INVALID_REQUEST_BODY`, `ORGANIZATION_ID_MISSING`, `TICKERS_MISSING`, `CHAT_MESSAGE_ID_MISSING`, `DOCUMENT_ID_MISSING`\n- Service: `SEARCH_FAIL`, `TTS_FAIL`, `CREATE_CONV_FAIL`, `GET_STOCK_FAIL`, `CREATE_MSG_FAIL`, `ALPHA_COMP_FAIL`, `GET_REF_FAIL`\n- Connectors: `CONNECTOR_LIST_FAIL`, `CONNECTOR_NOT_FOUND`, `CONNECTOR_CREATE_FAIL`, `CONNECTOR_UPDATE_FAIL`, `CONNECTOR_DELETE_FAIL`, `CONNECTOR_TEST_FAIL`\n- Not Found: `NOT_FOUND`\n- Meeting cancellation: `MEETING_NOT_FOUND`, `MEETING_NOT_CANCELABLE`, `MEETING_CANCEL_REASON_REQUIRED`, `MEETING_CANCEL_UNAVAILABLE`, `MEETING_CANCEL_FAIL`\n- Meeting compliance review: `MEETING_NOT_FOUND`, `MEETING_REVIEW_NOT_PERMITTED`, `MEETING_NOT_REVIEWABLE`, `MEETING_REVIEW_UNAVAILABLE`, `MEETING_REVIEW_FAIL`\n- Transcriptions: `TRANSCRIPTION_UPLOAD_FAIL`, `TRANSCRIPTION_SUBMIT_FAIL`, `TRANSCRIPTION_GET_FAIL`, `TRANSCRIPTION_NOT_FOUND`, `TRANSCRIPTION_REQUEST_INVALID`, `TRANSCRIPTION_RESULT_UNAVAILABLE` (503, poll again), `TRANSCRIPTION_SUBMIT_UNAVAILABLE` (503, submit again with the same Idempotency-Key)","example":"INVALID_REQUEST_BODY","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"msg":{"type":"string","description":"Error message (deprecated, use `message` instead)","example":"query is required and must be a string","uniqueKey":"error.msg","typeLabel":"string"},"message":{"type":"string","description":"Error message providing more details about the error","example":"query is required and must be a string","uniqueKey":"error.message","typeLabel":"string"}},"required":["code"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"payload":{"oneOf":[{"description":"Always null for error responses","isRequired":true,"uniqueKey":"payload.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses","type":"null","isRequired":true,"uniqueKey":"payload.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payload","typeLabel":"any | null"}},"required":["error","payload"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"SERVER_ERROR","message":"An unexpected error occurred on the server."},"payload":null},"examples":{"Example":{"title":"Example","value":{"error":{"code":"SERVER_ERROR","message":"An unexpected error occurred on the server."},"payload":null}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"8aa7599b-2dcb-4258-a16e-03ea68ad1736":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"9cdf8e58-8f32-4db6-a144-4d35b9596918":{"url":"https://api.linqalpha.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-KEY","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-KEY"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"linqalpha","siteName":"Linq Alpha API Docs","title":"Chat - Linq Alpha API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-26T02:35:36.789Z","originalFileLocation":"api-reference/basic/chat_v2.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=\"Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream. Note: For this search chat endpoint, the stock_id (BBG_ID) can be obtained by referring to the Map Tickers API and using the stock_id value from its response.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Linq Alpha API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/linqalpha/lrWql8nYb9-314d0/_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/linqalpha/lrWql8nYb9-314d0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/linqalpha/lrWql8nYb9-314d0/_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/linqalpha/lrWql8nYb9-314d0/_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/linqalpha/lrWql8nYb9-314d0/_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/linqalpha/lrWql8nYb9-314d0/_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/linqalpha/lrWql8nYb9-314d0/_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/linqalpha/lrWql8nYb9-314d0/_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/linqalpha/lrWql8nYb9-314d0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Chat - Linq Alpha API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream. Note: For this search chat endpoint, the stock_id (BBG_ID) can be obtained by referring to the Map Tickers API and using the stock_id value from its response.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Linq Alpha API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.linqalpha.com/api-reference/basic/chat_v2\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://linqalpha.mintlify.app/_mintlify/api/og/v2?division=Basic\u0026amp;title=Chat\u0026amp;description=Generate+a+response+from+the+LinqAlpha+engine.+LinqAlpha+uses+different+types+of+language+models+and+data+sources+to+generate+an+answer.+The+response+is+provide\u0026amp;theme=90ffa347c1039bd70010bd6c\u0026amp;signature=2c0fc21a1924f5eb846d1233f656d88435cdd24297168c2f9c9b5785af5b216b\">\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=\"Chat - Linq Alpha API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream. Note: For this search chat endpoint, the stock_id (BBG_ID) can be obtained by referring to the Map Tickers API and using the stock_id value from its response.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://linqalpha.mintlify.app/_mintlify/api/og/v2?division=Basic\u0026amp;title=Chat\u0026amp;description=Generate+a+response+from+the+LinqAlpha+engine.+LinqAlpha+uses+different+types+of+language+models+and+data+sources+to+generate+an+answer.+The+response+is+provide\u0026amp;theme=90ffa347c1039bd70010bd6c\u0026amp;signature=2c0fc21a1924f5eb846d1233f656d88435cdd24297168c2f9c9b5785af5b216b\">\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/linqalpha/lrWql8nYb9-314d0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Linq Alpha API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1767FE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.linqalpha.com/api-reference/basic/chat_v2\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/basic/chat_v2.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.linqalpha.com/#organization\",\"name\":\"Linq Alpha API Docs\",\"url\":\"https://docs.linqalpha.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/linqalpha/9BNJqkVKHb4kSYyJ/logo/light.svg?fit=max\u0026auto=format\u0026n=9BNJqkVKHb4kSYyJ\u0026q=85\u0026s=d7dd093386c0527ef6e6c9ef5f8130ad\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.linqalpha.com#website\",\"name\":\"Linq Alpha API Docs\",\"url\":\"https://docs.linqalpha.com\",\"publisher\":{\"@id\":\"https://docs.linqalpha.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.linqalpha.com/api-reference/basic/chat_v2#webpage\",\"url\":\"https://docs.linqalpha.com/api-reference/basic/chat_v2\",\"name\":\"Chat\",\"description\":\"Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream. Note: For this search chat endpoint, the stock_id (BBG_ID) can be obtained by referring to the Map Tickers API and using the stock_id value from its response.\",\"dateModified\":\"2026-06-26T02:35:36.789Z\",\"isPartOf\":{\"@id\":\"https://docs.linqalpha.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.linqalpha.com/api-reference/basic/chat_v2#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.linqalpha.com/api-reference/basic/chat_v2#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Basic\",\"item\":\"https://docs.linqalpha.com/api-reference/basic/map_tickers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Chat\",\"item\":\"https://docs.linqalpha.com/api-reference/basic/chat_v2\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.linqalpha.com/api-reference/basic/chat_v2#apireference\",\"headline\":\"Chat\",\"name\":\"Chat\",\"description\":\"Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream. Note: For this search chat endpoint, the stock_id (BBG_ID) can be obtained by referring to the Map Tickers API and using the stock_id value from its response.\",\"url\":\"https://docs.linqalpha.com/api-reference/basic/chat_v2\",\"mainEntityOfPage\":{\"@id\":\"https://docs.linqalpha.com/api-reference/basic/chat_v2#webpage\"},\"dateModified\":\"2026-06-26T02:35:36.789Z\",\"publisher\":{\"@id\":\"https://docs.linqalpha.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.linqalpha.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Linq Alpha API Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Linq Alpha API Docs","nav":{"global":{"anchors":[{"anchor":"Website","href":"https://linqalpha.com"}]},"tabs":[{"tab":"Quickstart","pages":[{"title":"Quickstart","href":"/quickstart"}]},{"tab":"API Reference","groups":[{"group":"MCP","pages":[{"title":"LinqAlpha MCP","openapi":"POST /v1/mcp","href":"/api-reference/basic/mcp"}]},{"group":"Basic","pages":[{"title":"Map Tickers","openapi":"GET /v1/map_tickers","href":"/api-reference/basic/map_tickers"},{"title":"Chat Message","openapi":"GET /v1/chat_messages/{chat_message_id}","href":"/api-reference/basic/chat_message"},{"title":"References","openapi":"GET /v1/references","href":"/api-reference/basic/references"},{"title":"References (v2)","openapi":"GET /v2/conversations/{conversation_id}/references","href":"/api-reference/basic/references_v2"},{"title":"Presigned URL","openapi":"GET /v1/documents/{document_id}/presigned_url","href":"/api-reference/basic/presigned_url"},{"title":"Batch Presigned URLs","openapi":"GET /v1/documents/batch_presigned_urls","href":"/api-reference/basic/batch_presigned_urls"},{"title":"Presigned URL V2","openapi":"GET /v2/documents/{document_id}/presigned_url","href":"/api-reference/basic/presigned_url_v2"},{"title":"Batch Presigned URLs V2","openapi":"GET /v2/documents/presigned_urls","href":"/api-reference/basic/batch_presigned_urls_v2"},{"title":"Customer Connectors","openapi":"GET /v2/connectors","href":"/api-reference/basic/connectors"},{"title":"Search","openapi":"POST /v1/search","href":"/api-reference/basic/search"},{"title":"TTSQL","openapi":"POST /v1/ttsql","description":"Converts natural language query to SQL, executes it, and returns results in markdown format","href":"/api-reference/basic/ttsql"},{"title":"Chat","openapi":"POST /v2/chat/sse","href":"/api-reference/basic/chat_v2"},{"title":"Analytics","openapi":"POST /v1/analytics/sse","description":"Generate an agentic analytics response via Server-Sent Events. This endpoint leverages multi-step reasoning with tool use to deliver deeper, more comprehensive answers compared to the standard search \u0026 generate endpoints.\n\nThe response stream includes message echo, thinking processes, tool calls with results, and the final answer.\n\n**Note:** Unlike `/v1/search` or `/v2/chat/sse`, this endpoint does not accept separate filter parameters (e.g., `stock_ids`, `tickers`, `external_types`, `upload_period`). Instead, include all filtering context directly in the `query` field. For example: `\"Analyze AAPL earnings trend from Q1 2024 to Q4 2025\"`.\n\n### Event Flow\n\n```\nconversation -> conversation_id for this session\nmessage -> echo of user query\nstatus: start -> stream begins\n+-- AGENTIC LOOP (repeats) ----------------------------+\n| tool_use_block -> 1-N parallel tool calls (batch)|\n| tool_result_block -> results for each call |\n| status: keep_alive -> heartbeat (if >15s gap) |\n| think (x N) -> reasoning tokens |\n+------------------------------------------------------+\nthink (x N) -> extended reasoning / draft\nanswer -> single chunk final answer\nstatus: finish -> stream ends\n```\n\n**One question at a time per conversation.** A request that arrives while an earlier question with the same `conversation_id` is still being answered can wait up to about 15 seconds and then end with a `status` event carrying `error` whose `code` is `SESSION_BUSY` (HTTP status is already `200`). The refused question is recorded in the conversation history but is not answered; send it again once the earlier answer completes.","href":"/api-reference/basic/analytics-sse"},{"title":"Stop Stream","openapi":"POST /v1/stop_stream","href":"/api-reference/basic/stop_stream"},{"title":"Conversation Feedback","openapi":"POST /v1/conversations/{conversation_id}/feedback","href":"/api-reference/basic/conversation_feedback"},{"title":"Delete Conversation Feedback","openapi":"DELETE /v1/conversations/{conversation_id}/feedback","href":"/api-reference/basic/delete_conversation_feedback"}]},{"group":"Analytics V2","pages":[{"title":"Analytics V2","openapi":"POST /v2/analytics/sse","href":"/api-reference/basic/analytics-sse-v2"},{"title":"Analytics V2 References","openapi":"GET /v2/analytics/conversations/{conversation_id}/references","href":"/api-reference/basic/analytics_references"},{"title":"Analytics V2 Judge","openapi":"POST /v2/analytics/messages/{chat_message_id}/judge","href":"/api-reference/basic/analytics_judge"},{"title":"Vault — Get Upload URL","openapi":"POST /v2/vault/presigned_url","href":"/api-reference/vault/presigned_url"},{"title":"Vault — Confirm Upload","openapi":"POST /v2/vault/confirm","href":"/api-reference/vault/confirm"},{"title":"Vault — Document Status","openapi":"GET /v2/vault/status","href":"/api-reference/vault/status"}]},{"group":"Transcriptions","tag":"NEW","pages":[{"title":"Transcriptions — Get Upload URL","openapi":"POST /v2/transcriptions/uploads","href":"/api-reference/transcriptions/upload"},{"title":"Transcriptions — Submit Job","openapi":"POST /v2/transcriptions","href":"/api-reference/transcriptions/create"},{"title":"Transcriptions — Poll / Retrieve","openapi":"GET /v2/transcriptions/{job_id}","href":"/api-reference/transcriptions/get"},{"title":"Transcriptions — Supported Languages","href":"/api-reference/transcriptions/languages"}]},{"group":"Evaluations","pages":[{"title":"Execute Agent Judge","openapi":"POST /v2/judge/agent","href":"/api-reference/evaluations/create"},{"title":"Get Agent Judge Evaluation","openapi":"GET /v2/judge/agent/{evaluation_id}","href":"/api-reference/evaluations/get"},{"title":"Execute LLM Judge","openapi":"POST /v2/judge/llm","href":"/api-reference/evaluations/create_llm"},{"title":"Get LLM Judge Evaluation","openapi":"GET /v2/judge/llm/{evaluation_id}","href":"/api-reference/evaluations/get_llm"}]},{"group":"RMS (On request)","pages":[{"title":"Source","openapi":"GET /v1/sources/{source_id}","tag":["New"],"href":"/api-reference/rms/source"},{"title":"Create Organization","openapi":"POST /v1/organizations","href":"/api-reference/rms/create_organization"},{"title":"Create Source Batch","openapi":"POST /v1/source_batches","tag":["New"],"href":"/api-reference/rms/create_source_batch"},{"title":"Get Upload URL","openapi":"POST /v1/sources/upload_url","tag":["New"],"href":"/api-reference/rms/upload_url"},{"title":"Create Source","openapi":"POST /v1/sources","tag":["New"],"href":"/api-reference/rms/create_source"},{"title":"RMS Chat","openapi":"POST /v1/rms_chat","href":"/api-reference/rms/rms_chat"},{"title":"RMS Deep Research","openapi":"POST /v1/rms_deep_research","href":"/api-reference/rms/rms_deep_research"}]},{"group":"Briefing","tag":"NEW","pages":[{"title":"Create Briefing Schedule","openapi":"POST /v1/briefings","href":"/api-reference/briefing/create"},{"title":"List Briefing Schedules","openapi":"GET /v1/briefings","href":"/api-reference/briefing/list"},{"title":"Update Briefing Schedule","openapi":"PATCH /v1/briefings/{id}","href":"/api-reference/briefing/update"},{"title":"Delete Briefing Schedule","openapi":"DELETE /v1/briefings/{id}","href":"/api-reference/briefing/delete"},{"title":"Preview Briefing On-Demand","openapi":"POST /v1/briefings/preview","href":"/api-reference/briefing/preview"},{"title":"List Deliveries","openapi":"GET /v1/briefings/{id}/deliveries","href":"/api-reference/briefing/deliveries"},{"title":"Get Delivery Detail","openapi":"GET /v1/briefings/deliveries/{delivery_id}","href":"/api-reference/briefing/delivery-detail"},{"title":"Get Delivery References","openapi":"GET /v1/briefings/deliveries/{delivery_id}/references","href":"/api-reference/briefing/delivery-references"},{"title":"Refresh External Content PDF Upload URL","openapi":"POST /v1/external_content/refresh_upload_url","href":"/api-reference/briefing/external-content-refresh-upload-url"}]},{"group":"Sync Status","tag":"NEW","pages":[{"title":"Organization Sync Status","openapi":"GET /v1/status/sync","href":"/api-reference/status/sync"},{"title":"Document Sync Status","openapi":"GET /v1/status/documents","href":"/api-reference/status/documents"},{"title":"Container Sync Status","openapi":"GET /v1/status/containers","href":"/api-reference/status/containers"}]},{"group":"Meeting Agent","pages":[{"title":"Cancel Meeting Agent","openapi":"POST /v1/meetings/{meeting_id}/cancel","href":"/api-reference/meetings/cancel"},{"title":"Approve Meeting Agent Results","openapi":"POST /v1/meetings/{meeting_id}/approve","href":"/api-reference/meetings/approve"},{"title":"Reject Meeting Agent Results","openapi":"POST /v1/meetings/{meeting_id}/reject","href":"/api-reference/meetings/reject"}]}]}]},"title":"Chat - Linq Alpha API Docs","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}