{
"detail": [
{
"type": "uuid_parsing",
"loc": [
"path",
"conversation_id"
],
"msg": "Input should be a valid UUID, invalid character: found `n` at 0",
"input": "not-a-uuid"
}
]
}
Conversations
List messages in a conversation
Returns messages oldest first. limit and offset count back from the newest message:
by default you get the newest 50, and offset=50 gives the 50 before those.
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/schema.json","name":"4Minds","colors":{"primary":"#0A0050","light":"#D2EA47","dark":"#80AEFF"},"logo":{"light":"https://mintcdn.com/4minds-e9525117/n55t5tM9OTD8RZz3/images/fullLogoBlack.svg?fit=max\u0026auto=format\u0026n=n55t5tM9OTD8RZz3\u0026q=85\u0026s=de05cef735fb33fa8abd7ec4a3b7e992","dark":"https://mintcdn.com/4minds-e9525117/n55t5tM9OTD8RZz3/images/fullLogoWhite.svg?fit=max\u0026auto=format\u0026n=n55t5tM9OTD8RZz3\u0026q=85\u0026s=fa0befc8a3557581e6e5607c6c09e77e"},"favicon":{"light":"https://mintcdn.com/4minds-e9525117/n55t5tM9OTD8RZz3/images/logoBlackNoPadding.svg?fit=max\u0026auto=format\u0026n=n55t5tM9OTD8RZz3\u0026q=85\u0026s=af25ea94e6530d7c568a88c4fb665c65","dark":"https://mintcdn.com/4minds-e9525117/n55t5tM9OTD8RZz3/images/logoWhiteNoPadding.svg?fit=max\u0026auto=format\u0026n=n55t5tM9OTD8RZz3\u0026q=85\u0026s=41ee2a402a0d7a1a1d946029979acaa4"},"background":{"color":{"light":"#E9EFFF","dark":"#0C0C0C"}},"seo":{"metatags":{"google-site-verification":"2ole44wh7D3TkErjYO6eqaku3pjF0TpC4L9fG6nv0f8"}},"fonts":{"heading":{"family":"Roboto"},"body":{"family":"Open Sans"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"4minds-e9525117","hasAudioNarration":false,"actualSubdomain":"4minds-e9525117","customDomains":["docs.4minds.ai"],"gitSource":{"type":"github","owner":"4minds-ai","repo":"4minds-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae2a8a3776bbe78b17b67dc","collectionId":"6a2d8c2b-3195-45e8-8980-a721b2980e58","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae2a8a3776bbe78b17b67dc"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae2a8a3776bbe78b17b67dc","clientVersion":"0.0.4064","searchFilterCounts":[{"language":"default","tag":"4Minds Features","count":26},{"language":"default","tag":"Developer Tools","count":18},{"language":"default","tag":"4Minds API","count":17},{"language":"default","tag":"4Minds API Endpoints","count":16},{"language":"default","tag":"Integrations","count":12},{"language":"default","tag":"SYMI","count":7},{"language":"default","tag":"Datasets","count":6},{"language":"default","tag":"Conversations","count":5},{"language":"default","tag":"Intro","count":4},{"language":"default","tag":"Models","count":4}]},"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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":".nav-logo{height:1.75rem!important;margin-left:-0.48rem!important}[class*=\"powered-by\"],[class*=\"PoweredBy\"],[class*=\"poweredBy\"],footer a[href*=\"mintlify.com\"],footer a[href*=\"mintlify\"]{display:none!important;visibility:hidden!important;opacity:0!important;height:0!important;width:0!important;overflow:hidden!important}#custom-legal-links a,#custom-legal-links .separator{margin-right:8px}#custom-legal-links .separator{margin-left:8px;opacity:0.6}footer [class*=\"legal\"]>span:first-child,footer [class*=\"legal\"]>div:first-child,footer h3,footer h4,footer h5{display:none!important}footer,footer *,footer::before,footer::after,footer *::before,footer *::after,[class*=\"footer\"],[class*=\"footer\"] *,[class*=\"footer\"]::before,[class*=\"footer\"]::after,[class*=\"footer\"] *::before,[class*=\"footer\"] *::after{border:none!important;border-top:none!important;border-bottom:none!important;border-left:none!important;border-right:none!important}footer hr,[class*=\"footer\"] hr{display:none!important}footer,footer>div,footer [class*=\"footer\"]{display:flex!important;flex-direction:column!important;align-items:center!important;width:100%!important;gap:5px!important}footer [class*=\"legal\"],footer nav,footer ul{display:flex!important;flex-direction:row!important;align-items:center!important;justify-content:center!important;gap:80px!important;flex-wrap:nowrap!important;white-space:nowrap!important;list-style:none!important;padding:0!important;margin:0!important;width:auto!important;max-width:100%!important;overflow-x:auto!important}footer [class*=\"legal\"] a,footer nav a,footer ul a,footer a[href*=\"4minds.ai\"]{display:inline-block!important;margin:0!important;padding:0!important;white-space:nowrap!important}footer [class*=\"legal\"] a:not(:last-child)::after,footer nav a:not(:last-child)::after,footer ul li:not(:last-child)::after,footer a[href*=\"4minds.ai\"]:not(:last-of-type)::after{content:\"\"!important;margin-left:0!important;margin-right:0!important}footer [class*=\"copyright\"],footer p:last-child,footer div:last-child{display:block!important;text-align:center!important;padding:10px 0!important;margin-top:5px!important;border:none!important;color:inherit!important;font-size:14px!important;width:100%!important;order:999!important}"}],"page":{"pagePath":"api-reference/conversations/list-messages-in-a-conversation","slug":"/api-reference/conversations/list-messages-in-a-conversation","pageMetadata":{"title":"List messages in a conversation","description":"Returns messages oldest first. `limit` and `offset` count back from the newest message:\nby default you get the newest 50, and `offset=50` gives the 50 before those.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/conversations/{conversation_id}/messages","href":"/api-reference/conversations/list-messages-in-a-conversation","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns messages oldest first. \", _jsx(_components.code, {\n children: \"limit\"\n }), \" and \", _jsx(_components.code, {\n children: \"offset\"\n }), \" count back from the newest message:\\nby default you get the newest 50, and \", _jsx(_components.code, {\n children: \"offset=50\"\n }), \" gives the 50 before those.\"]\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":"List messages in a conversation","description":"Returns messages oldest first. `limit` and `offset` count back from the newest message:\nby default you get the newest 50, and `offset=50` gives the 50 before those.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/conversations/{conversation_id}/messages","href":"/api-reference/conversations/list-messages-in-a-conversation","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/4minds-e9525117/e573413487c50684/custom-footer.js"],"openApiReferenceData":{"operation":{"tags":["Conversations"],"summary":"List messages in a conversation","operationId":"listConversationMessages","description":"Returns messages oldest first. `limit` and `offset` count back from the newest message:\nby default you get the newest 50, and `offset=50` gives the 50 before those.\n","parameters":["2c645789-381e-4e0b-a07d-ba6d337e9164","73d5e0ea-b25d-44fe-9f72-0a220bce2094","06fe7fb6-fd9e-4a3f-905a-cf1fd331abfb"],"responses":{"200":"cea88534-dbc1-41dd-b12c-b82195cffccf","401":"9617cda2-c3de-4adf-9fbd-5837f7ab923c","404":"b34d5fbc-809b-46a5-a283-8f9dbab66872","422":"5d9063ef-b544-4aae-9b32-54e8436bb45d"},"method":"get","type":"path","servers":["52cd19fe-cca3-4055-8983-37e09f4c8fcf"],"security":["c4f5b703-26ec-49d2-8a81-ae07c451d9ac"],"path":"/api/v1/user/conversations/{conversation_id}/messages","baseUrlOptions":["https://api.4minds.ai"],"title":"List messages in a conversation","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2c645789-381e-4e0b-a07d-ba6d337e9164":{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"73d5e0ea-b25d-44fe-9f72-0a220bce2094":{"name":"limit","in":"query","required":false,"description":"Number of messages to return. `0` or a negative value returns all messages.","schema":{"type":"integer","default":50,"isRequired":false,"description":"Number of messages to return. `0` or a negative value returns all messages.","uniqueKey":"","typeLabel":"integer"}},"06fe7fb6-fd9e-4a3f-905a-cf1fd331abfb":{"name":"offset","in":"query","required":false,"description":"Number of newest messages to skip.","schema":{"type":"integer","minimum":0,"default":0,"isRequired":false,"description":"Number of newest messages to skip.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"cea88534-dbc1-41dd-b12c-b82195cffccf":{"description":"Success.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["id","conversation_id","content","sender_type","timestamp","attachments","urls","response_metadata"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"items.[INDEX].id","typeLabel":"string\u003cuuid>"},"conversation_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"items.[INDEX].conversation_id","typeLabel":"string\u003cuuid>"},"content":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].content","typeLabel":"string"},"sender_type":{"type":"string","enum":["user","ai","status"],"description":"`status` messages are progress notes, e.g. `Retrieved 5 files successfully`.","isRequired":true,"uniqueKey":"items.[INDEX].sender_type","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"items.[INDEX].timestamp","typeLabel":"string\u003cdate-time>"},"attachments":{"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","uniqueKey":"items.[INDEX].attachments.items.[INDEX].filename","typeLabel":"string"}},"uniqueKey":"items.[INDEX].attachments.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"items.[INDEX].attachments","typeLabel":"object[]"},"urls":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].urls.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"items.[INDEX].urls","typeLabel":"string[]"},"response_metadata":{"type":"object","isRequired":true,"uniqueKey":"items.[INDEX].response_metadata","typeLabel":"object"}},"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","conversation_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","content":"\u003cstring>","sender_type":"user","timestamp":"2023-11-07T05:31:56Z","attachments":[{"filename":"\u003cstring>"}],"urls":["\u003cstring>"],"response_metadata":{}}]}},"exampleType":"generated"}},"exampleType":"generated"},"9617cda2-c3de-4adf-9fbd-5837f7ab923c":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"oneOf":[{"type":"string","description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","required":["type","loc","msg"],"properties":{"type":{"type":"string","examples":["missing"],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].type","typeLabel":"string"},"loc":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"examples":[["body","model_name"]],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].msg","typeLabel":"string"},"input":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","uniqueKey":"detail.oneOf.1.items.[INDEX].ctx","typeLabel":"object"}},"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"detail":"Authentication required"},"examples":{"Example":{"title":"Example","value":{"detail":"Authentication required"}}},"exampleType":"examples"}},"exampleType":"examples"},"b34d5fbc-809b-46a5-a283-8f9dbab66872":{"description":"The conversation doesn't exist.","content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"oneOf":[{"type":"string","description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","required":["type","loc","msg"],"properties":{"type":{"type":"string","examples":["missing"],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].type","typeLabel":"string"},"loc":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"examples":[["body","model_name"]],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].msg","typeLabel":"string"},"input":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","uniqueKey":"detail.oneOf.1.items.[INDEX].ctx","typeLabel":"object"}},"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"detail":"Conversation not found"},"examples":{"Example":{"title":"Example","value":{"detail":"Conversation not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"5d9063ef-b544-4aae-9b32-54e8436bb45d":{"description":"`conversation_id` is not a valid UUID.","content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"oneOf":[{"type":"string","description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","required":["type","loc","msg"],"properties":{"type":{"type":"string","examples":["missing"],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].type","typeLabel":"string"},"loc":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.oneOf.1.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"examples":[["body","model_name"]],"isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","isRequired":true,"uniqueKey":"detail.oneOf.1.items.[INDEX].msg","typeLabel":"string"},"input":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","uniqueKey":"detail.oneOf.1.items.[INDEX].ctx","typeLabel":"object"}},"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"An error message, or a list of validation errors.","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"detail":[{"type":"uuid_parsing","loc":["path","conversation_id"],"msg":"Input should be a valid UUID, invalid character: found `n` at 0","input":"not-a-uuid"}]},"examples":{"Example":{"title":"Example","value":{"detail":[{"type":"uuid_parsing","loc":["path","conversation_id"],"msg":"Input should be a valid UUID, invalid character: found `n` at 0","input":"not-a-uuid"}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c4f5b703-26ec-49d2-8a81-ae07c451d9ac":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Static, non-expiring API key: `Authorization: Bearer \u003cFOURMINDS_API_KEY>`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"52cd19fe-cca3-4055-8983-37e09f4c8fcf":{"url":"https://api.4minds.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Static, non-expiring API key: `Authorization: Bearer \u003cFOURMINDS_API_KEY>`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Static, non-expiring API key: `Authorization: Bearer \u003cFOURMINDS_API_KEY>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"4minds-e9525117","siteName":"4Minds","title":"List messages in a conversation - 4Minds","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T19:58:06.886Z","originalFileLocation":"api-reference/conversations/list-messages-in-a-conversation.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=\"Returns messages oldest first. limit and offset count back from the newest message: by default you get the newest 50, and offset=50 gives the 50 before those.\">\u003cmeta data-mint-head name=\"application-name\" content=\"4Minds\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_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/4minds-e9525117/6CsMLCM3QpHT3fB-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List messages in a conversation - 4Minds\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns messages oldest first. limit and offset count back from the newest message: by default you get the newest 50, and offset=50 gives the 50 before those.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"4Minds\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.4minds.ai/api-reference/conversations/list-messages-in-a-conversation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://4minds-e9525117.mintlify.app/_mintlify/api/og/v2?division=Conversations\u0026amp;title=List+messages+in+a+conversation\u0026amp;description=Returns+messages+oldest+first.+%60limit%60+and+%60offset%60+count+back+from+the+newest+message%3A%0Aby+default+you+get+the+newest+50%2C+and+%60offset%3D50%60+gives+the+50+before+th\u0026amp;theme=a08d550f1325906504303eba\u0026amp;signature=e9864ad2667353f59de0236fa2a11c71263dd8c14c95aba7bb842d9da0b196f9\">\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=\"List messages in a conversation - 4Minds\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns messages oldest first. limit and offset count back from the newest message: by default you get the newest 50, and offset=50 gives the 50 before those.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://4minds-e9525117.mintlify.app/_mintlify/api/og/v2?division=Conversations\u0026amp;title=List+messages+in+a+conversation\u0026amp;description=Returns+messages+oldest+first.+%60limit%60+and+%60offset%60+count+back+from+the+newest+message%3A%0Aby+default+you+get+the+newest+50%2C+and+%60offset%3D50%60+gives+the+50+before+th\u0026amp;theme=a08d550f1325906504303eba\u0026amp;signature=e9864ad2667353f59de0236fa2a11c71263dd8c14c95aba7bb842d9da0b196f9\">\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/4minds-e9525117/6CsMLCM3QpHT3fB-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"4Minds\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A0050\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"2ole44wh7D3TkErjYO6eqaku3pjF0TpC4L9fG6nv0f8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.4minds.ai/api-reference/conversations/list-messages-in-a-conversation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/conversations/list-messages-in-a-conversation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.4minds.ai/#organization\",\"name\":\"4Minds\",\"url\":\"https://docs.4minds.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/4minds-e9525117/n55t5tM9OTD8RZz3/images/fullLogoBlack.svg?fit=max\u0026auto=format\u0026n=n55t5tM9OTD8RZz3\u0026q=85\u0026s=de05cef735fb33fa8abd7ec4a3b7e992\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.4minds.ai#website\",\"name\":\"4Minds\",\"url\":\"https://docs.4minds.ai\",\"publisher\":{\"@id\":\"https://docs.4minds.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.4minds.ai/api-reference/conversations/list-messages-in-a-conversation#webpage\",\"url\":\"https://docs.4minds.ai/api-reference/conversations/list-messages-in-a-conversation\",\"name\":\"List messages in a conversation\",\"description\":\"Returns messages oldest first. limit and offset count back from the newest message: by default you get the newest 50, and offset=50 gives the 50 before those.\",\"dateModified\":\"2026-10-23T19:58:06.886Z\",\"isPartOf\":{\"@id\":\"https://docs.4minds.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.4minds.ai/api-reference/conversations/list-messages-in-a-conversation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.4minds.ai/api-reference/conversations/list-messages-in-a-conversation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Developer Tools\",\"item\":\"https://docs.4minds.ai/cloud-shell\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"4Minds API\",\"item\":\"https://docs.4minds.ai/api-overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"4Minds API Endpoints\",\"item\":\"https://docs.4minds.ai/api-reference/models/list-models\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Conversations\",\"item\":\"https://docs.4minds.ai/api-reference/conversations/list-conversations-for-a-model\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"List messages in a conversation\",\"item\":\"https://docs.4minds.ai/api-reference/conversations/list-messages-in-a-conversation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.4minds.ai/api-reference/conversations/list-messages-in-a-conversation#apireference\",\"headline\":\"List messages in a conversation\",\"name\":\"List messages in a conversation\",\"description\":\"Returns messages oldest first. limit and offset count back from the newest message: by default you get the newest 50, and offset=50 gives the 50 before those.\",\"url\":\"https://docs.4minds.ai/api-reference/conversations/list-messages-in-a-conversation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.4minds.ai/api-reference/conversations/list-messages-in-a-conversation#webpage\"},\"dateModified\":\"2026-10-23T19:58:06.886Z\",\"publisher\":{\"@id\":\"https://docs.4minds.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.4minds.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"4Minds\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"4Minds","nav":{"global":null,"groups":[{"group":"Intro","icon":"book-open","pages":[{"mode":"wide","title":"What is 4Minds","href":"/introduction"},{"title":"Key Advantages","href":"/key-advantages"},{"title":"Platform Architecture","href":"/platform-architecture"},{"title":"Security and Compliance","href":"/security"}]},{"group":"Getting Started with 4Minds","icon":"rocket","pages":[{"title":"Quick Start Guide","href":"/quickstart"}]},{"group":"Marketplace","icon":"store","pages":[{"group":"AWS","pages":[{"title":"AWS Marketplace: Helm Deployment","href":"/aws-marketplace"}]}]},{"group":"4Minds Features","icon":"sparkles","pages":[{"title":"Manage and Interact with Your Model","href":"/control-center"},{"title":"Explore the Model Dashboard","href":"/models"},{"title":"Evaluate your Model Performance","href":"/evaluations"},{"title":"Manage your Datasets","href":"/datasets"},{"title":"Personas","href":"/persona-configuration"},{"title":"Monitor Your Logs","hidden":true,"href":"/logging"},{"group":"Integrations","pages":[{"title":"Add Integrations \u0026 Data Sources","href":"/integrations"},{"title":"AWS Integrations","href":"/aws-integrations"},{"title":"Amazon RDS","href":"/rds"},{"title":"Amazon Redshift","href":"/redshift"},{"title":"Microsoft Fabric","href":"/microsoft-fabric"},{"title":"Microsoft Foundry","href":"/microsoft-foundry"},{"title":"Microsoft 365 Copilot","href":"/microsoft-365-copilot"},{"title":"Amazon Bedrock","href":"/bedrock"},{"title":"Databricks","href":"/databricks"},{"title":"dbt","href":"/dbt"},{"title":"Gong","href":"/gong"},{"title":"HubSpot","href":"/hubspot"}]},{"title":"Stay Updated with Real-Time Notifications","href":"/notifications"},{"title":"Organize your Teams","href":"/teams"},{"group":"SYMI","pages":[{"title":"SYMI Agentic AI Platform","href":"/symi"},{"title":"Memory","href":"/symi/memory"},{"title":"Persistent Workspace","href":"/symi/persistent-workspace"},{"title":"Skills, Sub-Agents, and Tools","href":"/symi/skills-system"},{"title":"Workspace Mirror","href":"/symi/workspace-mirror"},{"title":"Set up Workspace Mirror","href":"/symi/workspace-mirror-setup"},{"title":"Security \u0026 Isolation","href":"/symi/security-and-isolation"}]}]},{"group":"What's New in 4Minds","icon":"newspaper","pages":[{"title":"Changelog \u0026 Release Notes","href":"/changelog"}]},{"group":"Key Terms and Concepts in 4Minds","icon":"book","pages":[{"title":"Glossary","href":"/glossary"}]},{"group":"Developer Tools","icon":"code","pages":[{"title":"Cloud Shell","href":"/cloud-shell"},{"group":"4Minds API","pages":[{"title":"4Minds API Overview","href":"/api-overview"},{"group":"4Minds API Endpoints","pages":[{"group":"Models","pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/model","href":"/api-reference/models/list-models"},{"title":"Create a fine-tuned model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/model","href":"/api-reference/models/create-a-fine-tuned-model"},{"title":"Get a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/model/{model_id}","href":"/api-reference/models/get-a-model"},{"title":"Delete a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/user/model/{model_id}","href":"/api-reference/models/delete-a-model"}]},{"group":"Conversations","pages":[{"title":"List conversations for a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/conversations","href":"/api-reference/conversations/list-conversations-for-a-model"},{"title":"Create a conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/conversations","href":"/api-reference/conversations/create-a-conversation"},{"title":"Rename a conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/user/conversations/{conversation_id}","href":"/api-reference/conversations/rename-a-conversation"},{"title":"Delete a conversation","description":"Permanently deletes the conversation. Afterwards the conversation and its messages return 404.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/user/conversations/{conversation_id}","href":"/api-reference/conversations/delete-a-conversation"},{"title":"List messages in a conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/conversations/{conversation_id}/messages","href":"/api-reference/conversations/list-messages-in-a-conversation"}]},{"group":"Datasets","pages":[{"title":"List datasets","description":"Returns your datasets, most recently updated first. Soft-deleted datasets are not included.\n\nWithout `limit`, the response is an array of every matching dataset. With `limit`, the\nresponse is a paginated object (`items`, `total`, `limit`, `offset`, `has_more`).\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/dataset","href":"/api-reference/datasets/list-datasets"},{"title":"Create a dataset from files and/or URLs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/dataset","href":"/api-reference/datasets/create-a-dataset-from-files-andor-urls"},{"title":"Upload files to an existing dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/dataset/upload","href":"/api-reference/datasets/upload-files-to-an-existing-dataset"},{"title":"Get a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/dataset/{dataset_id}","href":"/api-reference/datasets/get-a-dataset"},{"title":"Delete a dataset (soft by default)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/user/dataset/{dataset_id}","href":"/api-reference/datasets/delete-a-dataset-soft-by-default"},{"title":"List files in a dataset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/user/dataset/{dataset_id}/files","href":"/api-reference/datasets/list-files-in-a-dataset"}]},{"group":"Inference","pages":[{"title":"Run an inference query (streaming SSE)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/user/inference","href":"/api-reference/inference/run-an-inference-query-streaming-sse"}]}]},{"title":"4Minds API Reference Old","hidden":true,"href":"/api-reference"}]}]}]},"basePath":"","title":"List messages in a conversation - 4Minds","buildId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","deploymentId":"dpl_2gSLkbMoF5kkLsBqYzq9KWtDyJRo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-hfTk6MZX.js","utils-Bfp7HcY4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D8dSW7yV.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CFgQXcZO.js","snippetPresets-dMW1-pV3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DyrCOido.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Bwwdcyh3.js","shallow-drVXTg79.js","getApiPlaygroundDisplay-GMPxUzWV.js","CodeSnippet-wTmV0wP6.js","CodeSnippets-D_QxCJEq.js","Page-BsZAA8xk.js","getPastedJson-Dev-X0Xy.js","icon-7L2WL0jD.js","MethodPill-Ble59Dl_.js","DuplicateIcon-r-98uLGh.js","createIcon-DaFzipjW.js","DynamicMarkdown-Jk8YAWGN.js","SectionHeading-nLgrCDOg.js","axios-vUo_bRtp.js","Markdown-_QGow1Wo.js","clsx-v8ssfMzu.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CjboTi0T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DkAyo-p5.js"]}