This endpoint allows you to retrieve a list of messages for a specific thread. Messages are an essential part of the thread, representing the conversation history between the user and the AI assistant.
This endpoint supports pagination in the same way as the Threads API. It uses the limit parameter to specify the maximum number of messages per request, and the after parameter as a cursor for pagination. The response includes a has_more parameter to indicate if more results are available.For detailed information on how pagination works, refer to the Threads API documentation.
A cursor for use in pagination. 'after' is a thread ID that defines your place in the list. For instance, if you make a list request and receive 100 threads, ending with thread 'xyz', your subsequent call can include after='xyz' in order to fetch the next page of the list. Pagination works the same as in the OpenAI API https://platform.openai.com/docs/api-reference/assistants/listAssistants.
The ID of the last thread in the list, or null if the list is empty.
Was this page helpful?
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Langtail Docs","colors":{"primary":"#4f46e5","light":"#6366F1","dark":"#4338CA"},"favicon":"/images/favicon.svg","logo":{"light":"https://mintcdn.com/langtail-64/21vrq2LQuE9wZl3n/images/logo/light.svg?fit=max\u0026auto=format\u0026n=21vrq2LQuE9wZl3n\u0026q=85\u0026s=9a2020ca308f997e25f1af399ddc13fa","dark":"https://mintcdn.com/langtail-64/21vrq2LQuE9wZl3n/images/logo/dark.svg?fit=max\u0026auto=format\u0026n=21vrq2LQuE9wZl3n\u0026q=85\u0026s=42611dc0b61af027330cd7fb358de292"},"appearance":{"default":"dark","strict":true},"navbar":{"links":[{"label":"Join Discord","href":"https://discord.com/invite/PpNqWYdBCS"}],"primary":{"type":"button","label":"Open Langtail","href":"https://app.langtail.com"}},"footer":{"socials":{"twitter":"https://twitter.com/langtail","youtube":"https://www.youtube.com/@langtail","linkedin":"https://www.linkedin.com/company/langtail"}},"integrations":{"mixpanel":{"projectToken":"d93a0106154a1a514d81ce1f02019340"}},"navigation":{"global":{"anchors":[{"anchor":"Community","href":"https://discord.com/invite/PpNqWYdBCS","icon":"discord"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"langtail-64","hasAudioNarration":false,"actualSubdomain":"langtail-64","customDomains":["langtail.com"],"gitSource":{"type":"github","owner":"langtail","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae91e89dad76a2288f7f3ec:success","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"Documentation","count":37},{"language":"default","tag":"Concepts and Examples","count":18},{"language":"default","tag":"References","count":12},{"language":"default","tag":"Threads","count":5},{"language":"default","tag":"Assistant messages in threads","count":5},{"language":"default","tag":"Playground","count":5},{"language":"default","tag":"Deployments","count":4},{"language":"default","tag":"OpenAI Proxy","count":4},{"language":"default","tag":"Tests","count":3},{"language":"default","tag":"Introduction","count":3}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/thread-messages","slug":"/api-reference/endpoint/thread-messages","pageMetadata":{"title":"List Thread Messages","openapi":"GET /v2/threads/{threadId}/messages","description":"Retrieves a list of messages for a specific thread.","href":"/api-reference/endpoint/thread-messages"},"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: \"Retrieves a list of messages for a specific thread.\"\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}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This endpoint allows you to retrieve a list of messages for a specific thread. Messages are an essential part of the thread, representing the conversation history between the user and the AI assistant.`}),`\n`,_jsx(Heading,{level:`2`,id:`pagination`,children:`Pagination`}),`\n`,_jsxs(_components.p,{children:[`This endpoint supports pagination in the same way as the Threads API. It uses the `,_jsx(_components.code,{children:`limit`}),` parameter to specify the maximum number of messages per request, and the `,_jsx(_components.code,{children:`after`}),` parameter as a cursor for pagination. The response includes a `,_jsx(_components.code,{children:`has_more`}),` parameter to indicate if more results are available.`]}),`\n`,_jsx(_components.p,{children:`For detailed information on how pagination works, refer to the Threads API documentation.`})]})}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":"List Thread Messages","openapi":"GET /v2/threads/{threadId}/messages","description":"Retrieves a list of messages for a specific thread.","href":"/api-reference/endpoint/thread-messages"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Pagination","slug":"pagination","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Retrieves a list of messages for a specific thread.","servers":["06d4b83c-8ee0-461b-8f5d-5ced8ac6bc9e"],"parameters":["f5311b33-eec0-427f-a00e-1ad05413489c","cc41b6d9-4523-4071-9d88-43b001c66939","88ac9f40-8e8f-4329-b8b7-d7fac20237f8","8b95e1d7-b609-412d-bd18-f4089ba673a8","7790d458-9c76-409f-9bf4-246af4376272"],"responses":{"200":"4a3bbcaa-eead-42c3-8417-1ca77ab68fe6","400":"61ada390-a74a-4d97-842e-b484a3b5a5c4","404":"9365b966-5241-4b99-96b9-5df6bc9a3d85"},"method":"get","type":"path","security":[],"path":"/v2/threads/{threadId}/messages","baseUrlOptions":["https://api.langtail.com"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f5311b33-eec0-427f-a00e-1ad05413489c":{"schema":{"type":"string","example":"\u003cLANGTAIL_API_KEY>","isRequired":true,"description":"Your Langtail API Key","uniqueKey":"","typeLabel":"string"},"required":true,"description":"Your Langtail API Key","name":"X-API-Key","in":"header"},"cc41b6d9-4523-4071-9d88-43b001c66939":{"name":"threadId","in":"path","required":true,"description":"The ID of the thread to retrieve messages from.","schema":{"type":"string","isRequired":true,"description":"The ID of the thread to retrieve messages from.","uniqueKey":"","typeLabel":"string"}},"88ac9f40-8e8f-4329-b8b7-d7fac20237f8":{"schema":{"oneOf":[{"type":"number","description":"The maximum number of threads to return. Default is 100.","uniqueKey":"oneOf.0","typeLabel":"number"},{"type":"null","description":"The maximum number of threads to return. Default is 100.","uniqueKey":"oneOf.1","typeLabel":"null"}],"uniqueKey":"","typeLabel":"number | null"},"name":"limit","in":"query","description":"The maximum number of threads to return. Default is 100."},"8b95e1d7-b609-412d-bd18-f4089ba673a8":{"schema":{"oneOf":[{"type":"string","description":"A cursor for use in pagination. 'after' is a thread ID that defines your place in the list. For instance, if you make a list request and receive 100 threads, ending with thread 'xyz', your subsequent call can include after='xyz' in order to fetch the next page of the list. Pagination works the same as in the OpenAI API https://platform.openai.com/docs/api-reference/assistants/listAssistants.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","description":"A cursor for use in pagination. 'after' is a thread ID that defines your place in the list. For instance, if you make a list request and receive 100 threads, ending with thread 'xyz', your subsequent call can include after='xyz' in order to fetch the next page of the list. Pagination works the same as in the OpenAI API https://platform.openai.com/docs/api-reference/assistants/listAssistants.","uniqueKey":"oneOf.1","typeLabel":"null"}],"uniqueKey":"","typeLabel":"string | null"},"name":"after","in":"query","description":"A cursor for use in pagination. 'after' is a thread ID that defines your place in the list. For instance, if you make a list request and receive 100 threads, ending with thread 'xyz', your subsequent call can include after='xyz' in order to fetch the next page of the list. Pagination works the same as in the OpenAI API https://platform.openai.com/docs/api-reference/assistants/listAssistants."},"7790d458-9c76-409f-9bf4-246af4376272":{"schema":{"oneOf":[{"type":"string","default":"asc","enum":["asc","desc"],"description":"The order of the messages. Default is 'asc' (oldest first). Use 'desc' for newest first.","uniqueKey":"oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","default":"asc","enum":["asc","desc"],"description":"The order of the messages. Default is 'asc' (oldest first). Use 'desc' for newest first.","uniqueKey":"oneOf.1","typeLabel":"null"}],"uniqueKey":"","typeLabel":"enum\u003cstring> | null"},"name":"order","in":"query","description":"The order of the messages. Default is 'asc' (oldest first). Use 'desc' for newest first."}},"responses":{"4a3bbcaa-eead-42c3-8417-1ca77ab68fe6":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier for the message.","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","description":"The timestamp when the message was created.","isRequired":true,"uniqueKey":"data.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"threadId":{"type":"string","description":"The ID of the thread this message belongs to.","isRequired":true,"uniqueKey":"data.items.[INDEX].threadId","typeLabel":"string"},"content":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string","enum":["assistant","user","system","function","tool"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"content":{"oneOf":[{"type":"string","description":"Text content","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","enum":["text"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.0.text","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","image_url"],"properties":{"type":{"type":"string","enum":["image_url"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"image_url":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.1.image_url.url","typeLabel":"string"},"detail":{"type":"string","enum":["auto","low","high"],"default":"auto","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.1.image_url.detail","typeLabel":"enum\u003cstring>"}},"required":["url","detail"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.1.image_url","typeLabel":"object"}},"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Mix of text and images.","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.1","typeLabel":"object[]"},{"description":"Can be omited if there is a `function_call` or `tool_calls`","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.2","typeLabel":"any"},{"type":"null","description":"Can be omited if there is a `function_call` or `tool_calls`","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content.oneOf.3","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].content","typeLabel":"string | object[] | any | null"},"function_call":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].function_call.name","typeLabel":"string"},"arguments":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].function_call.arguments","typeLabel":"string"}},"required":["name","arguments"],"uniqueKey":"data.items.[INDEX].content.items.[INDEX].function_call","typeLabel":"object"},"tool_calls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_calls.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["function"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_calls.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"function":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_calls.items.[INDEX].function.name","typeLabel":"string"},"arguments":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_calls.items.[INDEX].function.arguments","typeLabel":"string"}},"required":["name","arguments"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_calls.items.[INDEX].function","typeLabel":"object"}},"required":["id","type","function"],"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_calls.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_calls","typeLabel":"object[]"},"tool_choice":{"oneOf":[{"type":"string","enum":["auto"],"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_choice.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","enum":["none"],"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_choice.oneOf.1","typeLabel":"enum\u003cstring>"},{"type":"object","required":["type","function"],"properties":{"type":{"type":"string","enum":["function"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_choice.oneOf.2.type","typeLabel":"enum\u003cstring>"},"function":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_choice.oneOf.2.function.name","typeLabel":"string"}},"required":["name"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_choice.oneOf.2.function","typeLabel":"object"}},"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_choice.oneOf.2","typeLabel":"object"}],"uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_choice","typeLabel":"enum\u003cstring> · enum\u003cstring> · object"},"tool_call_id":{"type":"string","uniqueKey":"data.items.[INDEX].content.items.[INDEX].tool_call_id","typeLabel":"string"}},"required":["role","content"],"uniqueKey":"data.items.[INDEX].content.items.[INDEX]","typeLabel":"object"},"description":"Additional messages. These will be appended to the Prompt Template.","example":[{"role":"user","content":"Hello"}],"uniqueKey":"data.items.[INDEX].content","typeLabel":"object[]"},"requestLogId":{"oneOf":[{"type":"string","description":"The ID of the associated request log, if available.","uniqueKey":"data.items.[INDEX].requestLogId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the associated request log, if available.","uniqueKey":"data.items.[INDEX].requestLogId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].requestLogId","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","description":"A set of key-value pairs that can be attached to the message.","uniqueKey":"data.items.[INDEX].metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"A set of key-value pairs that can be attached to the message.","uniqueKey":"data.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].metadata","typeLabel":"object | null"}},"required":["id","createdAt","threadId"],"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"has_more":{"type":"boolean","description":"Whether there are more threads available after this batch.","isRequired":true,"uniqueKey":"has_more","typeLabel":"boolean"},"object":{"type":"string","enum":["list"],"description":"The object type, which is always 'list' for a list of messages.","uniqueKey":"object","typeLabel":"enum\u003cstring>"},"first_id":{"oneOf":[{"type":"string","description":"The ID of the first thread in the list, or null if the list is empty.","uniqueKey":"first_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the first thread in the list, or null if the list is empty.","uniqueKey":"first_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"first_id","typeLabel":"string | null"},"last_id":{"oneOf":[{"type":"string","description":"The ID of the last thread in the list, or null if the list is empty.","uniqueKey":"last_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the last thread in the list, or null if the list is empty.","uniqueKey":"last_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_id","typeLabel":"string | null"}},"required":["data","has_more"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"id":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","threadId":"\u003cstring>","content":[{"role":"user","content":"Hello"}],"requestLogId":"\u003cstring>","metadata":{}}],"has_more":true,"object":"list","first_id":"\u003cstring>","last_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"61ada390-a74a-4d97-842e-b484a3b5a5c4":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","example":"Invalid request parameters","uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Invalid request parameters"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9365b966-5241-4b99-96b9-5df6bc9a3d85":{"description":"Thread not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","example":"Thread not found","uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Thread not found"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"06d4b83c-8ee0-461b-8f5d-5ced8ac6bc9e":{"url":"https://api.langtail.com"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"langtail-64","siteName":"Langtail Docs","title":"List Thread Messages - Langtail Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T00:48:04.305Z","originalFileLocation":"api-reference/endpoint/thread-messages.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"dark\"}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=\"Retrieves a list of messages for a specific thread.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Langtail Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/langtail-64/gNTkU_HUz-gakvd9/_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=\"/docs/mintlify-assets/_mintlify/favicons/langtail-64/gNTkU_HUz-gakvd9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/langtail-64/gNTkU_HUz-gakvd9/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/langtail-64/gNTkU_HUz-gakvd9/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/langtail-64/gNTkU_HUz-gakvd9/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/langtail-64/gNTkU_HUz-gakvd9/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/langtail-64/gNTkU_HUz-gakvd9/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/langtail-64/gNTkU_HUz-gakvd9/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/langtail-64/gNTkU_HUz-gakvd9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Thread Messages - Langtail Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves a list of messages for a specific thread.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Langtail Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://langtail.com/docs/api-reference/endpoint/thread-messages\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://langtail-64.mintlify.site/docs/_mintlify/api/og/v2?division=Assistant+messages+in+threads\u0026amp;title=List+Thread+Messages\u0026amp;description=Retrieves+a+list+of+messages+for+a+specific+thread.\u0026amp;theme=3f4278914b3083aa55ddc90f\u0026amp;signature=da0bb9b6361181331edc60037a98aacfab4002264e57b10b1042e8ee200ba68c\">\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 Thread Messages - Langtail Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves a list of messages for a specific thread.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://langtail-64.mintlify.site/docs/_mintlify/api/og/v2?division=Assistant+messages+in+threads\u0026amp;title=List+Thread+Messages\u0026amp;description=Retrieves+a+list+of+messages+for+a+specific+thread.\u0026amp;theme=3f4278914b3083aa55ddc90f\u0026amp;signature=da0bb9b6361181331edc60037a98aacfab4002264e57b10b1042e8ee200ba68c\">\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=\"/docs/mintlify-assets/_mintlify/favicons/langtail-64/gNTkU_HUz-gakvd9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Langtail Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4f46e5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://langtail.com/docs/api-reference/endpoint/thread-messages\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/endpoint/thread-messages.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://langtail.com/#organization\",\"name\":\"Langtail Docs\",\"url\":\"https://langtail.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/langtail-64/21vrq2LQuE9wZl3n/images/logo/light.svg?fit=max\u0026auto=format\u0026n=21vrq2LQuE9wZl3n\u0026q=85\u0026s=9a2020ca308f997e25f1af399ddc13fa\"}},{\"@type\":\"WebSite\",\"@id\":\"https://langtail.com/docs#website\",\"name\":\"Langtail Docs\",\"url\":\"https://langtail.com/docs\",\"publisher\":{\"@id\":\"https://langtail.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://langtail.com/docs/api-reference/endpoint/thread-messages#webpage\",\"url\":\"https://langtail.com/docs/api-reference/endpoint/thread-messages\",\"name\":\"List Thread Messages\",\"description\":\"Retrieves a list of messages for a specific thread.\",\"dateModified\":\"2026-01-07T00:48:04.305Z\",\"isPartOf\":{\"@id\":\"https://langtail.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://langtail.com/docs/api-reference/endpoint/thread-messages#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://langtail.com/docs/api-reference/endpoint/thread-messages#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"References\",\"item\":\"https://langtail.com/docs/api-reference/endpoint/invoke-deployed-prompt\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Thread Messages\",\"item\":\"https://langtail.com/docs/api-reference/endpoint/thread-messages\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://langtail.com/docs/api-reference/endpoint/thread-messages#apireference\",\"headline\":\"List Thread Messages\",\"name\":\"List Thread Messages\",\"description\":\"Retrieves a list of messages for a specific thread.\",\"url\":\"https://langtail.com/docs/api-reference/endpoint/thread-messages\",\"mainEntityOfPage\":{\"@id\":\"https://langtail.com/docs/api-reference/endpoint/thread-messages#webpage\"},\"dateModified\":\"2026-01-07T00:48:04.305Z\",\"publisher\":{\"@id\":\"https://langtail.com/#organization\"},\"isPartOf\":{\"@id\":\"https://langtail.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Langtail Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Langtail Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/endpoint/thread-messages.md","siteName":"Langtail Docs","nav":{"global":{"anchors":[{"anchor":"Community","href":"https://discord.com/invite/PpNqWYdBCS","icon":"discord"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Introduction","pages":[{"title":"What is Langtail?","href":"/introduction/what-is-langtail"},{"title":"Getting started","href":"/introduction/getting-started"},{"title":"Main concepts in Langtail","sidebarTitle":"Main concepts in Langtail","href":"/introduction/main-concepts-in-langtail"}]},{"group":"Concepts and Examples","pages":[{"title":"Concepts and Examples Overview","sidebarTitle":"Overview","href":"/concepts-and-examples/overview"},{"group":"Playground","pages":[{"title":"Playground Overview","sidebarTitle":"Overview","href":"/concepts-and-examples/playground/overview"},{"title":"Prompt Templating","href":"/concepts-and-examples/playground/templating"},{"title":"Assistants \u0026 Threads","sidebarTitle":"Assistants \u0026 Threads","href":"/concepts-and-examples/playground/assistants-threads"},{"title":"Variables","href":"/concepts-and-examples/playground/variables"},{"title":"Tools","href":"/concepts-and-examples/playground/tools"}]},{"group":"Tests","pages":[{"title":"Tests Overview","sidebarTitle":"Overview","href":"/concepts-and-examples/tests/overview"},{"title":"Basic Tests","href":"/concepts-and-examples/tests/basic-tests"},{"title":"Advanced tests","sidebarTitle":"Advanced tests","href":"/concepts-and-examples/tests/adv-tests"}]},{"group":"Deployments","pages":[{"title":"Deployments Overview","sidebarTitle":"Overview","href":"/concepts-and-examples/deployments/overview"},{"title":"Deploy Prompt","href":"/concepts-and-examples/deployments/deploy-prompt"},{"title":"API keys and Env Variables","href":"/concepts-and-examples/deployments/api-keys"}]},{"group":"Logs and Metrics","pages":[{"title":"Logs and Metrics Overview","sidebarTitle":"Overview","href":"/concepts-and-examples/logs-and-metrics/overview"}]},{"group":"OpenAI Proxy","pages":[{"title":"Integrate via Langtail SDK","href":"/concepts-and-examples/proxy/integrate-sdk"},{"title":"Integrate via OpenAI library","href":"/concepts-and-examples/proxy/openai"},{"title":"Integrate via REST API","href":"/concepts-and-examples/proxy/rest"},{"title":"Integrate via Langchain","href":"/concepts-and-examples/proxy/langchain"}]},{"group":"SDKs","pages":[{"title":"TypeScript SDK","href":"/concepts-and-examples/sdks/typescript"}]}]},{"group":"References","pages":[{"group":"Deployments","pages":[{"title":"Invoke Deployed Prompt","openapi":"POST /{workspace}/{project}/{prompt}/{environment}","href":"/api-reference/endpoint/invoke-deployed-prompt"}]},{"group":"Assistants","pages":[{"title":"Invoke Assistant","openapi":"POST /{workspace}/{project}/{assistant}/{environment}","href":"/api-reference/endpoint/invoke-assistant"}]},{"group":"Threads","pages":[{"title":"List Threads","openapi":"GET /v2/threads","href":"/api-reference/endpoint/threads"},{"title":"Create a Thread","openapi":"POST /v2/threads","href":"/api-reference/endpoint/create-thread"},{"title":"Thread by ID","openapi":"GET /v2/threads/{threadId}","href":"/api-reference/endpoint/thread"},{"title":"Delete a Thread by ID","openapi":"DELETE /v2/threads/{threadId}","href":"/api-reference/endpoint/delete-thread"},{"title":"Update a Thread by ID","openapi":"POST /v2/threads/{threadId}","description":"Updates a thread's metadata by its ID.","href":"/api-reference/endpoint/update-thread"}]},{"group":"Assistant messages in threads","pages":[{"title":"List Thread Messages","openapi":"GET /v2/threads/{threadId}/messages","href":"/api-reference/endpoint/thread-messages"},{"title":"Create Thread Message","openapi":"POST /v2/threads/{threadId}/messages","description":"Create a new message in a thread.","href":"/api-reference/endpoint/create-thread-message"},{"title":"Get Thread Message","openapi":"GET /v2/threads/{threadId}/messages/{messageId}","href":"/api-reference/endpoint/thread-message"},{"title":"Update Thread Message","openapi":"POST /v2/threads/{threadId}/messages/{messageId}","href":"/api-reference/endpoint/update-message"},{"title":"Delete Thread Message","openapi":"DELETE /v2/threads/{threadId}/messages/{messageId}","href":"/api-reference/endpoint/delete-thread-message"}]}]},{"group":"Media \u0026 Presentations","pages":[{"title":"Make Chatbots Better | WebExpo Talk","sidebarTitle":"Make Chatbots Better","href":"/media-presentations/web-expo"},{"title":"Deepnote | Case study","url":"https://langtail.com/customers/deepnote","href":"/media-presentations/deepnote-case"}]},{"group":"Support \u0026 Community","pages":[{"title":"Changelog","href":"/support/changelog"},{"title":"Get Help","href":"/support/get-help"}]}]}]},"basePath":"","title":"List Thread Messages - Langtail Docs","buildId":"dpl_AHzSCQPRq6mP9FZXEa5AbDZTffie","deploymentId":"dpl_AHzSCQPRq6mP9FZXEa5AbDZTffie","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C0w-WQJ2.js","utils-C5d2irbo.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CJr73d5s.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B9xqpnhe.js","snippetPresets-C6Ms_vrL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C4vTqKLT.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dvb1kse5.js","shallow-BIuit-p4.js","getApiPlaygroundDisplay-B4qYxU7P.js","CodeSnippet-DbbDcn2_.js","CodeSnippets-P3qMtezt.js","Page-DLEGoKJA.js","getPastedJson-rlg7qTiW.js","icon-ChyN3MIj.js","MethodPill-BDbONhDa.js","DuplicateIcon-CJlrtq8z.js","createIcon-BDOguHRU.js","DynamicMarkdown-mBxoveKr.js","SectionHeading-CAMJotVi.js","axios-vUo_bRtp.js","Markdown-BNXMbgxP.js","clsx-4BR7cppx.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CAwBMBkB.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CJogWhER.js"]}