{ "text": "I apologize for the confusion. According to the information you provided earlier, your favorite number is 444.", "credits_used": 0.02885, "credits_remaining": 1853.71700}
Conversation Endpoints
Chat with knowledge base
Continue an existing conversation thread with your assistant
GET
/
api
/
conversation
/
{conversationId}
Chat with knowledge base
curl --request GET \ --url https://api.getpoppy.ai/api/conversation/{conversationId} \ --header 'api_key: <api-key>'
{ "text": "I apologize for the confusion. According to the information you provided earlier, your favorite number is 444.", "credits_used": 0.02885, "credits_remaining": 1853.71700}
This endpoint lets you continue an ongoing conversation with your assistant, keeping the context from previous messages.
URL Parameters
string
required
The ID of the to continue the conversation with
Query Parameters
string
Your API key for authentication
string
required
The ID of the board to use for the conversation
string
required
The ID of the chat node within the board
string
required
The follow-up question or prompt for the AI
string
default:"claude-sonnet-5"
The AI model to use. Allowed values: claude-sonnet-5, claude-sonnet-4-6, claude-sonnet-4-5,
o3-mini, gpt-4o, grok-2-1212, gpt-4o-mini
boolean
Whether save the answer in the chat
string
default:false
Force the AI response to use plain text instead of markdown. Allowed values are “true” or
“active”. Any other value will disable plaintext.
string
default:false
Return the answer as a stream instead of a JSON. Allowed values are “true” or “active”. Any other
value will disable streaming.
string
default:false
When streaming is enabled, set this to “true” or “active” to receive credit usage information as a final chunk
in the stream. The usage chunk will be appended after the finish event with the format:
{"type":"usage","credits_used":0.123}. This is similar to OpenAI’s stream_options.include_usage parameter.
string
default:" "
Additional information to provide as context to the AI
string
Optional user identifier
string
Optional source of the request
Response
string
The AI-generated response to the prompt
number
The number of credits used for this request
number
The total number of credits remaining in your account
{ "text": "I apologize for the confusion. According to the information you provided earlier, your favorite number is 444.", "credits_used": 0.02885, "credits_remaining": 1853.71700}
This endpoint is functionally equivalent to the POST /api/conversation/ endpoint,
but allows for easier testing and integration in contexts where POST requests are difficult to
implement.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"POPPY AI Documentation","colors":{"primary":"#5046e5","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/getpoppyai/d5VZJxx0NUXD2c7y/logo/poppy-png-gang.png?fit=max\u0026auto=format\u0026n=d5VZJxx0NUXD2c7y\u0026q=85\u0026s=62e19a2e5525490c465737db5d8e00bc","dark":"https://mintcdn.com/getpoppyai/d5VZJxx0NUXD2c7y/logo/poppy-png-gang.png?fit=max\u0026auto=format\u0026n=d5VZJxx0NUXD2c7y\u0026q=85\u0026s=62e19a2e5525490c465737db5d8e00bc"},"favicon":"https://mintcdn.com/getpoppyai/d5VZJxx0NUXD2c7y/favicon-poppy.ico?fit=max\u0026auto=format\u0026n=d5VZJxx0NUXD2c7y\u0026q=85\u0026s=73e522864cd2eafa3fa3bcc8abb7afb1","api":{"mdx":{"auth":{"method":"key","name":"api_key"},"server":"https://api.getpoppy.ai"}},"navbar":{"links":[{"href":"mailto:support@getpoppy.ai","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/NazDumanskyy","instagram":"https://www.instagram.com/getpoppyai","linkedin":"https://www.linkedin.com/company/poppy-ai"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"getpoppyai","hasAudioNarration":false,"actualSubdomain":"getpoppyai","customDomains":["docs.getpoppy.ai"],"gitSource":{"type":"github","owner":"naz-qazi","repo":"poppy","deployBranch":"main","contentDirectory":"internal/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6abedf7aeecbc5880dac1cb2","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Conversation Endpoints","count":5},{"language":"default","tag":"Board and Chat Endpoints","count":2},{"language":"default","tag":"Made with Poppy AI","count":2},{"language":"default","tag":"Examples","count":2},{"language":"default","tag":"API Documentation","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":"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":"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},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/endpoint/conversation-message-via-get","slug":"/api-reference/endpoint/conversation-message-via-get","pageMetadata":{"title":"Chat with knowledge base","api":"GET /api/conversation/{conversationId}","description":"Continue an existing conversation thread with your assistant","href":"/api-reference/endpoint/conversation-message-via-get"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Continue an existing conversation thread with your assistant\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components},{Heading,Note,ParamField,ResponseField}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This endpoint lets you continue an ongoing conversation with your assistant, keeping the context from previous messages.`}),`\n`,_jsx(Heading,{level:`2`,id:`url-parameters`,children:`URL Parameters`}),`\n`,_jsx(ParamField,{path:`conversationId`,type:`string`,required:true,id:`param-conversation-id`,children:_jsx(_components.p,{children:`The ID of the to continue the conversation with`})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`api_key`,type:`string`,id:`param-api-key`,children:_jsx(_components.p,{children:`Your API key for authentication`})}),`\n`,_jsx(ParamField,{query:`board_id`,type:`string`,required:true,id:`param-board-id`,children:_jsx(_components.p,{children:`The ID of the board to use for the conversation`})}),`\n`,_jsx(ParamField,{query:`chat_id`,type:`string`,required:true,id:`param-chat-id`,children:_jsx(_components.p,{children:`The ID of the chat node within the board`})}),`\n`,_jsx(ParamField,{query:`prompt`,type:`string`,required:true,id:`param-prompt`,children:_jsx(_components.p,{children:`The follow-up question or prompt for the AI`})}),`\n`,_jsx(ParamField,{query:`model`,type:`string`,default:`claude-sonnet-5`,id:`param-model`,children:_jsx(_components.p,{children:`The AI model to use. Allowed values: claude-sonnet-5, claude-sonnet-4-6, claude-sonnet-4-5,\no3-mini, gpt-4o, grok-2-1212, gpt-4o-mini`})}),`\n`,_jsx(ParamField,{query:`save_history`,type:`boolean`,id:`param-save-history`,children:_jsx(_components.p,{children:`Whether save the answer in the chat`})}),`\n`,_jsx(ParamField,{query:`plaintext`,type:`string`,default:false,id:`param-plaintext`,children:_jsx(_components.p,{children:`Force the AI response to use plain text instead of markdown. Allowed values are “true” or\n“active”. Any other value will disable plaintext.`})}),`\n`,_jsx(ParamField,{query:`streaming`,type:`string`,default:false,id:`param-streaming`,children:_jsx(_components.p,{children:`Return the answer as a stream instead of a JSON. Allowed values are “true” or “active”. Any other\nvalue will disable streaming.`})}),`\n`,_jsx(ParamField,{query:`include_usage`,type:`string`,default:false,id:`param-include-usage`,children:_jsxs(_components.p,{children:[`When streaming is enabled, set this to “true” or “active” to receive credit usage information as a final chunk\nin the stream. The usage chunk will be appended after the `,_jsx(_components.code,{children:`finish`}),` event with the format:\n`,_jsx(_components.code,{children:`{\"type\":\"usage\",\"credits_used\":0.123}`}),`. This is similar to OpenAI’s `,_jsx(_components.code,{children:`stream_options.include_usage`}),` parameter.`]})}),`\n`,_jsx(ParamField,{query:`additional_context`,type:`string`,default:` `,id:`param-additional-context`,children:_jsx(_components.p,{children:`Additional information to provide as context to the AI`})}),`\n`,_jsx(ParamField,{query:`user`,type:`string`,id:`param-user`,children:_jsx(_components.p,{children:`Optional user identifier`})}),`\n`,_jsx(ParamField,{query:`source`,type:`string`,id:`param-source`,children:_jsx(_components.p,{children:`Optional source of the request`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`text`,type:`string`,id:`param-text`,children:_jsx(_components.p,{children:`The AI-generated response to the prompt`})}),`\n`,_jsx(ResponseField,{name:`credits_used`,type:`number`,id:`param-credits-used`,children:_jsx(_components.p,{children:`The number of credits used for this request`})}),`\n`,_jsx(ResponseField,{name:`credits_remaining`,type:`number`,id:`param-credits-remaining`,children:_jsx(_components.p,{children:`The total number of credits remaining in your account`})}),`\n`,`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This endpoint is functionally equivalent to the POST /api/conversation/`,` endpoint,\nbut allows for easier testing and integration in contexts where POST requests are difficult to\nimplement.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Chat with knowledge base","api":"GET /api/conversation/{conversationId}","description":"Continue an existing conversation thread with your assistant","href":"/api-reference/endpoint/conversation-message-via-get"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[199,298,"pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if"],[455,470,"Example)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingM"],[4290,4307,"_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`200 OK`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"I apologize for the confusion. According to the information you provided earlier, your favorite number is 444.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credits_used\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.02885`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credits_remaining\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1853.71700`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsx(Note,{ch"]]},"mdxExtracts":{"tableOfContents":[{"title":"URL Parameters","slug":"url-parameters","depth":2,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"200 OK","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"text\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"I apologize for the confusion. According to the information you provided earlier, your favorite number is 444.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"credits_used\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0.02885\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"credits_remaining\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1853.71700\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Chat with knowledge base","path":"/api/conversation/{conversationId}","servers":[{"url":"https://api.getpoppy.ai"}],"method":"get","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"api_key":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{"api_key":{"schema":[{"type":"string","description":"Your API key for authentication"}]},"board_id":{"schema":[{"type":"string","description":"The ID of the board to use for the conversation","required":true}]},"chat_id":{"schema":[{"type":"string","description":"The ID of the chat node within the board","required":true}]},"prompt":{"schema":[{"type":"string","description":"The follow-up question or prompt for the AI","required":true}]},"model":{"schema":[{"type":"string","description":"The AI model to use. Allowed values: claude-sonnet-5, claude-sonnet-4-6, claude-sonnet-4-5, o3-mini, gpt-4o, grok-2-1212, gpt-4o-mini"}]},"save_history":{"schema":[{"type":"boolean","description":"Whether save the answer in the chat"}]},"plaintext":{"schema":[{"type":"string","description":"Force the AI response to use plain text instead of markdown. Allowed values are “true” or “active”. Any other value will disable plaintext."}]},"streaming":{"schema":[{"type":"string","description":"Return the answer as a stream instead of a JSON. Allowed values are “true” or “active”. Any other value will disable streaming."}]},"include_usage":{"schema":[{"type":"string","description":"When streaming is enabled, set this to “true” or “active” to receive credit usage information as a final chunk in the stream. The usage chunk will be appended after the `finish` event with the format: `{\"type\":\"usage\",\"credits_used\":0.123}` . This is similar to OpenAI’s `stream_options.include_usage` parameter."}]},"additional_context":{"schema":[{"type":"string","description":"Additional information to provide as context to the AI"}]},"user":{"schema":[{"type":"string","description":"Optional user identifier"}]},"source":{"schema":[{"type":"string","description":"Optional source of the request"}]}},"header":{},"cookie":{},"path":{"conversationId":{"schema":[{"type":"string","description":"The ID of the to continue the conversation with","required":true}]}}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"text":[{"type":"string","description":"The AI-generated response to the prompt"}],"credits_used":[{"type":"number","description":"The number of credits used for this request"}],"credits_remaining":[{"type":"number","description":"The total number of credits remaining in your account"}]}}],"examples":{"example":{"value":{"text":"\u003cstring>","credits_used":123,"credits_remaining":123}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"getpoppyai","siteName":"POPPY AI Documentation","title":"Chat with knowledge base - POPPY AI Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-18T16:38:30.007Z","originalFileLocation":"api-reference/endpoint/conversation-message-via-get.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=\"Continue an existing conversation thread with your assistant\">\u003cmeta data-mint-head name=\"application-name\" content=\"POPPY AI Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/getpoppyai/psFwbNskKKzSTTxO/_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/getpoppyai/psFwbNskKKzSTTxO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/getpoppyai/psFwbNskKKzSTTxO/_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/getpoppyai/psFwbNskKKzSTTxO/_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/getpoppyai/psFwbNskKKzSTTxO/_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/getpoppyai/psFwbNskKKzSTTxO/_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/getpoppyai/psFwbNskKKzSTTxO/_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/getpoppyai/psFwbNskKKzSTTxO/_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/getpoppyai/psFwbNskKKzSTTxO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Chat with knowledge base - POPPY AI Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Continue an existing conversation thread with your assistant\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"POPPY AI Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-message-via-get\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://getpoppyai.mintlify.site/_mintlify/api/og/v2?division=Conversation+Endpoints\u0026amp;title=Chat+with+knowledge+base\u0026amp;description=Continue+an+existing+conversation+thread+with+your+assistant\u0026amp;theme=93827e953d02c3ee565b2630\u0026amp;signature=51f5f7c5d7bcc321631a62270de5edb3a81a2814c002e4e91c11eeb0f062de0c\">\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 with knowledge base - POPPY AI Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Continue an existing conversation thread with your assistant\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://getpoppyai.mintlify.site/_mintlify/api/og/v2?division=Conversation+Endpoints\u0026amp;title=Chat+with+knowledge+base\u0026amp;description=Continue+an+existing+conversation+thread+with+your+assistant\u0026amp;theme=93827e953d02c3ee565b2630\u0026amp;signature=51f5f7c5d7bcc321631a62270de5edb3a81a2814c002e4e91c11eeb0f062de0c\">\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/getpoppyai/psFwbNskKKzSTTxO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"POPPY AI Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5046e5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-message-via-get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/conversation-message-via-get.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getpoppy.ai/#organization\",\"name\":\"POPPY AI Documentation\",\"url\":\"https://docs.getpoppy.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/getpoppyai/d5VZJxx0NUXD2c7y/logo/poppy-png-gang.png?fit=max\u0026auto=format\u0026n=d5VZJxx0NUXD2c7y\u0026q=85\u0026s=62e19a2e5525490c465737db5d8e00bc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getpoppy.ai#website\",\"name\":\"POPPY AI Documentation\",\"url\":\"https://docs.getpoppy.ai\",\"publisher\":{\"@id\":\"https://docs.getpoppy.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-message-via-get#webpage\",\"url\":\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-message-via-get\",\"name\":\"Chat with knowledge base\",\"description\":\"Continue an existing conversation thread with your assistant\",\"dateModified\":\"2026-07-18T16:38:30.007Z\",\"isPartOf\":{\"@id\":\"https://docs.getpoppy.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-message-via-get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-message-via-get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Conversation Endpoints\",\"item\":\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-ask-via-get\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Chat with knowledge base\",\"item\":\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-message-via-get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-message-via-get#apireference\",\"headline\":\"Chat with knowledge base\",\"name\":\"Chat with knowledge base\",\"description\":\"Continue an existing conversation thread with your assistant\",\"url\":\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-message-via-get\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getpoppy.ai/api-reference/endpoint/conversation-message-via-get#webpage\"},\"dateModified\":\"2026-07-18T16:38:30.007Z\",\"publisher\":{\"@id\":\"https://docs.getpoppy.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getpoppy.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"POPPY AI Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"POPPY AI Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/conversation-message-via-get.md","siteName":"POPPY AI Documentation","nav":{"global":{"anchors":[]},"tabs":[{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Quickstart","href":"/api-reference/quickstart"}]},{"group":"Conversation Endpoints","pages":[{"title":"Ask knowledge base","api":"GET /api/conversation","href":"/api-reference/endpoint/conversation-ask-via-get"},{"title":"Ask knowledge base","api":"POST /api/conversation","description":"Ask a single question from the chat assistant and connected knowledge base","href":"/api-reference/endpoint/conversation-ask-via-post"},{"title":"Chat with knowledge base","api":"GET /api/conversation/{conversationId}","href":"/api-reference/endpoint/conversation-message-via-get"},{"title":"Chat with knowledge base","api":"POST /api/conversation/{conversationId}","description":"Continue an existing conversation thread with your assistant","href":"/api-reference/endpoint/conversation-message-via-post"},{"title":"Create conversation","api":"POST /api/conversation/new","href":"/api-reference/endpoint/conversation-create-via-post"}]},{"group":"Board and Chat Endpoints","pages":[{"title":"Get boards","api":"GET /api/boards","href":"/api-reference/endpoint/get-boards"},{"title":"Get chats","api":"GET /api/chats","href":"/api-reference/endpoint/get-chat-nodes"}]}]},{"tab":"Made with Poppy AI","pages":[{"title":"Made with Poppy AI","href":"/examples/slack-chatbot"}]}]},"basePath":"","title":"Chat with knowledge base - POPPY AI Documentation","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js"]}