A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.
order
enum<string>
default:desc
Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
Available options:
asc,
desc
after
string
A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
before
string
A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.
run_id
string
Filter messages by the run ID that generated them.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"OpenAI","colors":{"primary":"#000","light":"#fff","dark":"#000"},"logo":{"light":"https://mintcdn.com/openai-hd4n6/HWyWa8TnHmjonR6q/logo/light.svg?fit=max\u0026auto=format\u0026n=HWyWa8TnHmjonR6q\u0026q=85\u0026s=b3c0a58c9a5d827106eaf4d197a8776d","dark":"https://mintcdn.com/openai-hd4n6/HWyWa8TnHmjonR6q/logo/dark.svg?fit=max\u0026auto=format\u0026n=HWyWa8TnHmjonR6q\u0026q=85\u0026s=9747beab1aa209ce2275e2ef08f2608e","href":"https://platform.openai.com"},"favicon":"/favicon.svg","appearance":{"default":"light"},"background":{"color":{"dark":"#000"}},"navbar":{"links":[],"primary":{"type":"button","label":"Dashboard","href":"https://platform.openai.com"}},"footer":{"socials":{"x":"https://x.com/OpenAIDevs","youtube":"https://www.youtube.com/OpenAI","linkedin":"https://www.linkedin.com/company/openai","github":"https://github.com/openai","instagram":"https://www.instagram.com/openai?hl=en","discord":"https://discord.gg/openai"}},"search":{"prompt":"Search"},"fonts":{"heading":{"family":"OpenAI Sans Medium","source":"https://cdn.openai.com/common/fonts/openai-sans/OpenAISans-Medium.woff2","format":"woff2"},"body":{"family":"OpenAI Sans Regular","source":"https://cdn.openai.com/common/fonts/openai-sans/OpenAISans-Regular.woff2","format":"woff2"}},"icons":{"library":"lucide"},"styling":{"codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-14E5SKGN55"}},"contextual":{"options":["copy","view","chatgpt","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openai-hd4n6","hasAudioNarration":false,"actualSubdomain":"openai-hd4n6","customDomains":[],"gitSource":{"type":"github","owner":"ruhanponnada","repo":"openai-demo","deployBranch":"main","contentDirectory":"docs-content","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"REMOVE_BRANDING":{"status":"DISABLED"}},"buildId":"6ae9276c702a829ff5a9d0ee:success","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"API reference","count":149},{"language":"default","tag":"Assistants","count":23},{"language":"default","tag":"Projects","count":19},{"language":"default","tag":"Vector stores","count":16},{"language":"default","tag":"Docs","count":13},{"language":"default","tag":"Evals","count":12},{"language":"default","tag":"Certificates","count":10},{"language":"default","tag":"Fine-tuning","count":9},{"language":"default","tag":"Usage","count":9},{"language":"default","tag":"Chat","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"site-roles","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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":[{"filePath":"styles.css","content":":root{--rounded-sm: 8px;--rounded: 8px;--rounded-md: 8px;--rounded-lg: 8px;--rounded-xl: 8px;--rounded-2xl: 8px;--rounded-search: 8px;--rounded-3xl: 8px;--rounded-full: 8px;--card-gradient-hover: linear-gradient(90deg,rgba(86,88,105,.5),rgba(86,88,105,.6),rgba(86,88,105,.7));--text-default: #acacbe;--gray-0: #fff;--gray-100: #ececf1;--green-600: #10a37f;--green-700: #1a7f64;--method-pill-bg: linear-gradient( 45deg, rgba(0, 0, 0, .4) 0%, rgba(0, 0, 0, .2) 100% );--side-nav-width: 216px;--docs-page-max-width: 680px}:root.dark{--gray-100: #353740;--gray-400: #acacbe;--gray-600: #6e6e80;--text-secondary: var(--gray-400)}*{scrollbar-width:thin}.rounded-\\[14px\\]{border-radius:8px}#sidebar-content{width:var(--side-nav-width)}#content-area{max-width:var(--docs-page-max-width)}#content-container{> div {\n column-gap: 1.5rem;\n }\n \n @media (min-width: 1024px) {\n margin-left: var(--side-nav-width);\n }}.dark\\:text-gray-400:is(.dark *){color:var(--text-secondary)!important}.mdx-content{color:#353740!important}.dark .mdx-content{color:var(--text-default)!important}.dark{#content-container {\n background-color: #202123 !important;\n }\n\n div[data-component-part=\"accordion-caret-right\"] > svg {\n background-color: #9ea3a2 !important;\n }}#search-bar-entry{.dark \u0026 {\n border: 1px solid #565869;\n }\n\n border: 1px solid #d9d9e3;}#page-title{font-weight:600}.method-pill{background:transparent!important;color:var(--text-secondary)!important}.tryit-button{background-color:var(--green-600)!important}.mdx-content{.link {\n border-bottom: none;\n }\n\n .link:hover {\n border-bottom: none;\n }}.dark .button-link{border:1px solid #6B7280!important}.button-link{border:1px solid #1a202c!important}.prose{line-height:1.6em;a code {\n text-decoration: none;\n color: var(--green-600) !important;\n }}#topbar-cta-button>a{background-color:#10a37f}.card{background-color:transparent!important;border:none!important;margin-bottom:20px;> div {\n align-items: start;\n padding: 0;\n }\n\n [data-component-part=\"card-title\"] {\n font-weight: 500;\n }\n\n [data-component-part=\"card-icon\"] {\n background-color: transparent;\n border: 1px solid #ececf1;\n \n .dark \u0026 {\n background: linear-gradient(90deg,rgba(86,88,105,.5),rgba(86,88,105,.6),rgba(86,88,105,.7));\n border: none\n }\n \n border-radius: var(--rounded);\n width: 48px;\n height: 48px;\n display: flex;\n justify-content: center;\n align-items: center;\n flex-shrink: 0;\n\n > svg {\n color: white;\n }\n }}.navbar-link{@media (min-width: 1024px){background-color:#6e6e80!important;\u0026:hover{background-color:#565869!important}color:#fff!important;> a {\n color: inherit !important;\n \u0026:hover {\n color: inherit !important;\n }\n }}}.method-nav-pill{display:none}.bottom-anchor:hover{background-color:#8e8ea020;transition:background-color 0.15s ease}.panel{max-height:100%;min-height:18rem;.code-block {\n margin: 0;\n display: grid;\n overflow: hidden;\n width: 100%;\n\n [data-component-part=\"code-block-root\"] {\n overflow: auto;\n\n > div {\n overflow-y: unset !important;\n overflow-x: unset !important;\n }\n }\n }}ul[data-component-part=\"tabs-list\"]:not(.api-section ul[data-component-part=\"tabs-list\"]){margin-bottom:0.5rem;border-radius:var(--rounded-xl);border:none;padding:2px;gap:0;flex-wrap:wrap;width:fit-content;min-width:fit-content;overflow-x:auto;background-color:#ececf1;.dark \u0026 {\n background-color: black;\n }\n\n [data-component-part=\"tab-button\"] {\n border: none;\n padding: 3px 12px;\n font-size: 14px;\n font-weight: 600;\n border-radius: var(--rounded-xl);\n margin: 0;\n }\n\n [data-component-part=\"tab-button\"] {\n color: var(--text-secondary) !important;\n }\n\n [data-component-part=\"tab-button\"].text-primary {\n background-color: white !important;\n .dark \u0026 {\n background-color: #353740 !important;\n }\n\n color: black !important;\n .dark \u0026 {\n color: white !important;\n }\n }}#sidebar-content button:nth-child(2){display:none}body:has(.frame-context) #content-side-layout,html:has(.frame-context) #content-side-layout{display:none!important}body:has(.frame-context) #content-area,html:has(.frame-context) #content-area{max-width:100%!important}body:has(.frame-context) .mdx-content,html:has(.frame-context) .mdx-content{max-width:none!important;width:100%!important;padding-left:10rem!important;padding-right:10rem!important;padding-top:3rem!important}"}]}
{"page":{"pagePath":"api-reference/assistants/list-messages","slug":"/api-reference/assistants/list-messages","pageMetadata":{"title":"List messages","description":"Returns a list of messages for a given thread.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}/messages","href":"/api-reference/assistants/list-messages","autogeneratedByOpenApi":true,"hidden":false},"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: \"Returns a list of messages for a given 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}=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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"List messages","description":"Returns a list of messages for a given thread.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}/messages","href":"/api-reference/assistants/list-messages","autogeneratedByOpenApi":true,"hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"listMessages","tags":["Assistants"],"summary":"List messages","description":"Returns a list of messages for a given thread.","parameters":["019d0957-d0cf-43c1-852d-a05c67378c63","729552b7-53e9-4249-88fd-76b9211d89a0","d0d17428-b564-46ef-bb0b-ced38a21112c","bf15aad1-67f8-45a0-8014-d420bd80ce26","733d6aa4-4591-42aa-a02e-04194a5ccf0c","169dd96d-7e61-4e17-9eb2-ffe268522dcb"],"responses":{"200":"cb622b3a-f027-4e56-b723-a6305758dc99"},"x-oaiMeta":{"name":"List messages","group":"threads","beta":true,"returns":"A list of [message](/docs/api-reference/messages) objects.","examples":{"request":{"curl":"curl https://api.openai.com/v1/threads/thread_abc123/messages \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer $OPENAI_API_KEY\" \\\n -H \"OpenAI-Beta: assistants=v2\"\n","python":"from openai import OpenAI\nclient = OpenAI()\n\nthread_messages = client.beta.threads.messages.list(\"thread_abc123\")\nprint(thread_messages.data)\n","node.js":"import OpenAI from \"openai\";\n\nconst openai = new OpenAI();\n\nasync function main() {\n const threadMessages = await openai.beta.threads.messages.list(\n \"thread_abc123\"\n );\n\n console.log(threadMessages.data);\n}\n\nmain();"},"response":"{\n \"object\": \"list\",\n \"data\": [\n {\n \"id\": \"msg_abc123\",\n \"object\": \"thread.message\",\n \"created_at\": 1699016383,\n \"assistant_id\": null,\n \"thread_id\": \"thread_abc123\",\n \"run_id\": null,\n \"role\": \"user\",\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": {\n \"value\": \"How does AI work? Explain it in simple terms.\",\n \"annotations\": []\n }\n }\n ],\n \"attachments\": [],\n \"metadata\": {}\n },\n {\n \"id\": \"msg_abc456\",\n \"object\": \"thread.message\",\n \"created_at\": 1699016383,\n \"assistant_id\": null,\n \"thread_id\": \"thread_abc123\",\n \"run_id\": null,\n \"role\": \"user\",\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": {\n \"value\": \"Hello, what is AI?\",\n \"annotations\": []\n }\n }\n ],\n \"attachments\": [],\n \"metadata\": {}\n }\n ],\n \"first_id\": \"msg_abc123\",\n \"last_id\": \"msg_abc456\",\n \"has_more\": false\n}\n"}},"method":"get","type":"path","servers":["9f61e0a7-2685-4550-b083-a2e42a567582"],"security":["efccd957-87b8-4ae7-bd76-926423fe0b10"],"path":"/threads/{thread_id}/messages","baseUrlOptions":["https://api.openai.com/v1"],"title":"List messages","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"019d0957-d0cf-43c1-852d-a05c67378c63":{"in":"path","name":"thread_id","required":true,"schema":{"type":"string","isRequired":true,"description":"The ID of the [thread](/docs/api-reference/threads) the messages belong to.","uniqueKey":"","typeLabel":"string"},"description":"The ID of the [thread](/docs/api-reference/threads) the messages belong to."},"729552b7-53e9-4249-88fd-76b9211d89a0":{"name":"limit","in":"query","description":"A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.\n","required":false,"schema":{"type":"integer","default":20,"isRequired":false,"description":"A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.\n","uniqueKey":"","typeLabel":"integer"}},"d0d17428-b564-46ef-bb0b-ced38a21112c":{"name":"order","in":"query","description":"Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending order.\n","schema":{"type":"string","default":"desc","enum":["asc","desc"],"description":"Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending order.\n","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"bf15aad1-67f8-45a0-8014-d420bd80ce26":{"name":"after","in":"query","description":"A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.\n","schema":{"type":"string","description":"A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.\n","uniqueKey":"","typeLabel":"string"}},"733d6aa4-4591-42aa-a02e-04194a5ccf0c":{"name":"before","in":"query","description":"A cursor for use in pagination. `before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.\n","schema":{"type":"string","description":"A cursor for use in pagination. `before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.\n","uniqueKey":"","typeLabel":"string"}},"169dd96d-7e61-4e17-9eb2-ffe268522dcb":{"name":"run_id","in":"query","description":"Filter messages by the run ID that generated them.\n","schema":{"type":"string","description":"Filter messages by the run ID that generated them.\n","uniqueKey":"","typeLabel":"string"}}},"responses":{"cb622b3a-f027-4e56-b723-a6305758dc99":{"description":"OK","content":{"application/json":{"schema":{"properties":{"object":{"type":"string","example":"list","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"data":{"type":"array","items":{"type":"object","title":"The message object","description":"Represents a message within a [thread](/docs/api-reference/threads).","properties":{"id":{"description":"The identifier, which can be referenced in API endpoints.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"object":{"description":"The object type, which is always `thread.message`.","type":"string","enum":["thread.message"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"created_at":{"description":"The Unix timestamp (in seconds) for when the message was created.","type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].created_at","typeLabel":"integer"},"thread_id":{"description":"The [thread](/docs/api-reference/threads) ID that this message belongs to.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].thread_id","typeLabel":"string"},"status":{"description":"The status of the message, which can be either `in_progress`, `incomplete`, or `completed`.","type":"string","enum":["in_progress","incomplete","completed"],"isRequired":true,"uniqueKey":"data.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"incomplete_details":{"oneOf":[{"description":"On an incomplete message, details about why the message is incomplete.","type":"object","properties":{"reason":{"type":"string","description":"The reason the message is incomplete.","enum":["content_filter","max_tokens","run_cancelled","run_expired","run_failed"],"isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete_details.oneOf.0.reason","typeLabel":"enum\u003cstring>"}},"required":["reason"],"isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete_details.oneOf.0","typeLabel":"object"},{"description":"On an incomplete message, details about why the message is incomplete.","type":"null","properties":{"reason":{"type":"string","description":"The reason the message is incomplete.","enum":["content_filter","max_tokens","run_cancelled","run_expired","run_failed"]}},"required":["reason"],"isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete_details.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete_details","typeLabel":"object | null"},"completed_at":{"oneOf":[{"description":"The Unix timestamp (in seconds) for when the message was completed.","type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].completed_at.oneOf.0","typeLabel":"integer"},{"description":"The Unix timestamp (in seconds) for when the message was completed.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].completed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].completed_at","typeLabel":"integer | null"},"incomplete_at":{"oneOf":[{"description":"The Unix timestamp (in seconds) for when the message was marked as incomplete.","type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete_at.oneOf.0","typeLabel":"integer"},{"description":"The Unix timestamp (in seconds) for when the message was marked as incomplete.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete_at","typeLabel":"integer | null"},"role":{"description":"The entity that produced the message. One of `user` or `assistant`.","type":"string","enum":["user","assistant"],"isRequired":true,"uniqueKey":"data.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"content":{"description":"The content of the message in array of text and/or images.","type":"array","items":{"oneOf":[{"type":"object","title":"Image file","description":"References an image [File](/docs/api-reference/files) in the content of a message.","required":["type","image_file"],"x-oaiExpandable":true,"properties":{"type":{"description":"Always `image_file`.","type":"string","enum":["image_file"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"image_file":{"type":"object","properties":{"file_id":{"description":"The [File](/docs/api-reference/files) ID of the image in the message content. Set `purpose=\"vision\"` when uploading the File if you need to later display the file content.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.0.image_file.file_id","typeLabel":"string"},"detail":{"type":"string","description":"Specifies the detail level of the image if specified by the user. `low` uses fewer tokens, you can opt in to high resolution using `high`.","enum":["auto","low","high"],"default":"auto","uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.0.image_file.detail","typeLabel":"enum\u003cstring>"}},"required":["file_id"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.0.image_file","typeLabel":"object"}},"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.0","typeLabel":"Image file · object"},{"type":"object","title":"Image URL","description":"References an image URL in the content of a message.","required":["type","image_url"],"x-oaiExpandable":true,"properties":{"type":{"type":"string","enum":["image_url"],"description":"The type of the content part.","x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"image_url":{"type":"object","properties":{"url":{"type":"string","description":"The external URL of the image, must be a supported image types: jpeg, jpg, png, gif, webp.","format":"uri","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.1.image_url.url","typeLabel":"string\u003curi>"},"detail":{"type":"string","description":"Specifies the detail level of the image. `low` uses fewer tokens, you can opt in to high resolution using `high`. Default value is `auto`","enum":["auto","low","high"],"default":"auto","uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.1.image_url.detail","typeLabel":"enum\u003cstring>"}},"required":["url"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.1.image_url","typeLabel":"object"}},"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.1","typeLabel":"Image URL · object"},{"type":"object","title":"Text","description":"The text content that is part of a message.","required":["type","text"],"x-oaiExpandable":true,"properties":{"type":{"description":"Always `text`.","type":"string","enum":["text"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"text":{"type":"object","properties":{"value":{"description":"The data that makes up the text.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.value","typeLabel":"string"},"annotations":{"type":"array","items":{"oneOf":[{"type":"object","title":"File citation","description":"A citation within the message that points to a specific quote from a specific File associated with the assistant or the message. Generated when the assistant uses the \"file_search\" tool to search files.","required":["type","text","file_citation","start_index","end_index"],"x-oaiExpandable":true,"properties":{"type":{"description":"Always `file_citation`.","type":"string","enum":["file_citation"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"text":{"description":"The text in the message content that needs to be replaced.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.0.text","typeLabel":"string"},"file_citation":{"type":"object","properties":{"file_id":{"description":"The ID of the specific File the citation is from.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.0.file_citation.file_id","typeLabel":"string"}},"required":["file_id"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.0.file_citation","typeLabel":"object"},"start_index":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.0.start_index","typeLabel":"integer"},"end_index":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.0.end_index","typeLabel":"integer"}},"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.0","typeLabel":"File citation · object"},{"type":"object","title":"File path","description":"A URL for the file that's generated when the assistant used the `code_interpreter` tool to generate a file.","required":["type","text","file_path","start_index","end_index"],"x-oaiExpandable":true,"properties":{"type":{"description":"Always `file_path`.","type":"string","enum":["file_path"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"text":{"description":"The text in the message content that needs to be replaced.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.1.text","typeLabel":"string"},"file_path":{"type":"object","properties":{"file_id":{"description":"The ID of the file that was generated.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.1.file_path.file_id","typeLabel":"string"}},"required":["file_id"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.1.file_path","typeLabel":"object"},"start_index":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.1.start_index","typeLabel":"integer"},"end_index":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.1.end_index","typeLabel":"integer"}},"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX].oneOf.1","typeLabel":"File path · object"}],"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations.items.[INDEX]","typeLabel":"File citation · object | File path · object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text.annotations","typeLabel":"(File citation · object | File path · object)[]"}},"required":["value","annotations"],"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2.text","typeLabel":"object"}},"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.2","typeLabel":"Text · object"},{"type":"object","title":"Refusal","description":"The refusal content generated by the assistant.","required":["type","refusal"],"x-oaiExpandable":true,"properties":{"type":{"description":"Always `refusal`.","type":"string","enum":["refusal"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"refusal":{"type":"string","nullable":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.3.refusal","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].content.items.[INDEX].oneOf.3","typeLabel":"Refusal · object"}],"uniqueKey":"data.items.[INDEX].content.items.[INDEX]","typeLabel":"Image file · object | Image URL · object | Text · object | Refusal · object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].content","typeLabel":"(Image file · object | Image URL · object | Text · object | Refusal · object)[]"},"assistant_id":{"oneOf":[{"description":"If applicable, the ID of the [assistant](/docs/api-reference/assistants) that authored this message.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].assistant_id.oneOf.0","typeLabel":"string"},{"description":"If applicable, the ID of the [assistant](/docs/api-reference/assistants) that authored this message.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].assistant_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].assistant_id","typeLabel":"string | null"},"run_id":{"oneOf":[{"description":"The ID of the [run](/docs/api-reference/runs) associated with the creation of this message. Value is `null` when messages are created manually using the create message or create thread endpoints.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].run_id.oneOf.0","typeLabel":"string"},{"description":"The ID of the [run](/docs/api-reference/runs) associated with the creation of this message. Value is `null` when messages are created manually using the create message or create thread endpoints.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].run_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].run_id","typeLabel":"string | null"},"attachments":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"file_id":{"type":"string","description":"The ID of the file to attach to the message.","uniqueKey":"data.items.[INDEX].attachments.oneOf.0.items.[INDEX].file_id","typeLabel":"string"},"tools":{"description":"The tools to add this file to.","type":"array","items":{"oneOf":[{"type":"object","title":"Code interpreter tool","required":["type"],"x-oaiExpandable":true,"properties":{"type":{"type":"string","description":"The type of tool being defined: `code_interpreter`","enum":["code_interpreter"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.oneOf.0.items.[INDEX].tools.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.items.[INDEX].attachments.oneOf.0.items.[INDEX].tools.items.[INDEX].oneOf.0","typeLabel":"Code interpreter tool · object"},{"type":"object","title":"FileSearch tool","required":["type"],"x-oaiExpandable":true,"properties":{"type":{"type":"string","description":"The type of tool being defined: `file_search`","enum":["file_search"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.oneOf.0.items.[INDEX].tools.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.items.[INDEX].attachments.oneOf.0.items.[INDEX].tools.items.[INDEX].oneOf.1","typeLabel":"FileSearch tool · object"}],"uniqueKey":"data.items.[INDEX].attachments.oneOf.0.items.[INDEX].tools.items.[INDEX]","typeLabel":"Code interpreter tool · object | FileSearch tool · object"},"uniqueKey":"data.items.[INDEX].attachments.oneOf.0.items.[INDEX].tools","typeLabel":"(Code interpreter tool · object | FileSearch tool · object)[]"}},"uniqueKey":"data.items.[INDEX].attachments.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"A list of files attached to the message, and the tools they were added to.","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"file_id":{"type":"string","description":"The ID of the file to attach to the message."},"tools":{"description":"The tools to add this file to.","type":"array","items":{"oneOf":[{"type":"object","title":"Code interpreter tool","required":["type"],"x-oaiExpandable":true,"properties":{"type":{"type":"string","description":"The type of tool being defined: `code_interpreter`","enum":["code_interpreter"],"x-stainless-const":true}}},{"type":"object","title":"FileSearch tool","required":["type"],"x-oaiExpandable":true,"properties":{"type":{"type":"string","description":"The type of tool being defined: `file_search`","enum":["file_search"],"x-stainless-const":true}}}]}}}},"description":"A list of files attached to the message, and the tools they were added to.","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].attachments","typeLabel":"object[] | null"},"metadata":{"oneOf":[{"type":"object","description":"Set of 16 key-value pairs that can be attached to an object. This can be\nuseful for storing additional information about the object in a structured\nformat, and querying for objects via API or the dashboard. \n\nKeys are strings with a maximum length of 64 characters. Values are strings\nwith a maximum length of 512 characters.\n","additionalProperties":{"type":"string","uniqueKey":"data.items.[INDEX].metadata.oneOf.0.additionalProperties","typeLabel":"string"},"x-oaiTypeLabel":"map","isRequired":true,"uniqueKey":"data.items.[INDEX].metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"Set of 16 key-value pairs that can be attached to an object. This can be\nuseful for storing additional information about the object in a structured\nformat, and querying for objects via API or the dashboard. \n\nKeys are strings with a maximum length of 64 characters. Values are strings\nwith a maximum length of 512 characters.\n","additionalProperties":{"type":"string","uniqueKey":"data.items.[INDEX].metadata.oneOf.1.additionalProperties","typeLabel":"string"},"x-oaiTypeLabel":"map","isRequired":true,"uniqueKey":"data.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].metadata","typeLabel":"object | null"}},"required":["id","object","created_at","thread_id","status","incomplete_details","completed_at","incomplete_at","role","content","assistant_id","run_id","attachments","metadata"],"x-oaiMeta":{"name":"The message object","beta":true,"example":"{\n \"id\": \"msg_abc123\",\n \"object\": \"thread.message\",\n \"created_at\": 1698983503,\n \"thread_id\": \"thread_abc123\",\n \"role\": \"assistant\",\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": {\n \"value\": \"Hi! How can I help you today?\",\n \"annotations\": []\n }\n }\n ],\n \"assistant_id\": \"asst_abc123\",\n \"run_id\": \"run_abc123\",\n \"attachments\": [],\n \"metadata\": {}\n}\n"},"uniqueKey":"data.items.[INDEX]","typeLabel":"The message object · object"},"isRequired":true,"uniqueKey":"data","typeLabel":"The message object · object[]"},"first_id":{"type":"string","example":"msg_abc123","isRequired":true,"uniqueKey":"first_id","typeLabel":"string"},"last_id":{"type":"string","example":"msg_abc123","isRequired":true,"uniqueKey":"last_id","typeLabel":"string"},"has_more":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"has_more","typeLabel":"boolean"}},"required":["object","data","first_id","last_id","has_more"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"list","data":[{"id":"\u003cstring>","object":"thread.message","created_at":123,"thread_id":"\u003cstring>","status":"in_progress","incomplete_details":{"reason":"content_filter"},"completed_at":123,"incomplete_at":123,"role":"user","content":[{"type":"image_file","image_file":{"file_id":"\u003cstring>","detail":"auto"}}],"assistant_id":"\u003cstring>","run_id":"\u003cstring>","attachments":[{"file_id":"\u003cstring>","tools":[{"type":"code_interpreter"}]}],"metadata":{}}],"first_id":"msg_abc123","last_id":"msg_abc123","has_more":false}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"efccd957-87b8-4ae7-bd76-926423fe0b10":{"ApiKeyAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"9f61e0a7-2685-4550-b083-a2e42a567582":{"url":"https://api.openai.com/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-definition.yaml"},"subdomain":"openai-hd4n6","siteName":"OpenAI","title":"List messages - OpenAI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T07:53:42.257Z","originalFileLocation":"api-reference/assistants/list-messages.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=\"light\"}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 a list of messages for a given thread.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenAI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openai-hd4n6/3-BrUvhorgOaO5kV/_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/openai-hd4n6/3-BrUvhorgOaO5kV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openai-hd4n6/3-BrUvhorgOaO5kV/_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/openai-hd4n6/3-BrUvhorgOaO5kV/_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/openai-hd4n6/3-BrUvhorgOaO5kV/_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/openai-hd4n6/3-BrUvhorgOaO5kV/_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/openai-hd4n6/3-BrUvhorgOaO5kV/_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/openai-hd4n6/3-BrUvhorgOaO5kV/_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/openai-hd4n6/3-BrUvhorgOaO5kV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List messages - OpenAI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a list of messages for a given thread.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenAI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-messages\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openai-hd4n6.mintlify.site/_mintlify/api/og/v2?division=Assistants\u0026amp;title=List+messages\u0026amp;description=Returns+a+list+of+messages+for+a+given+thread.\u0026amp;theme=7b37e8ffcf4d9c1fcde78b1c\u0026amp;signature=34db294186ffa5885663d0d6132ec2a2d461c0498cde0115d8e87365366ffcfd\">\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 - OpenAI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a list of messages for a given thread.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openai-hd4n6.mintlify.site/_mintlify/api/og/v2?division=Assistants\u0026amp;title=List+messages\u0026amp;description=Returns+a+list+of+messages+for+a+given+thread.\u0026amp;theme=7b37e8ffcf4d9c1fcde78b1c\u0026amp;signature=34db294186ffa5885663d0d6132ec2a2d461c0498cde0115d8e87365366ffcfd\">\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/openai-hd4n6/3-BrUvhorgOaO5kV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenAI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-messages\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/assistants/list-messages.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://openai-hd4n6.mintlify.app/#organization\",\"name\":\"OpenAI\",\"url\":\"https://openai-hd4n6.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openai-hd4n6/HWyWa8TnHmjonR6q/logo/light.svg?fit=max\u0026auto=format\u0026n=HWyWa8TnHmjonR6q\u0026q=85\u0026s=b3c0a58c9a5d827106eaf4d197a8776d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://openai-hd4n6.mintlify.app#website\",\"name\":\"OpenAI\",\"url\":\"https://openai-hd4n6.mintlify.app\",\"publisher\":{\"@id\":\"https://openai-hd4n6.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-messages#webpage\",\"url\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-messages\",\"name\":\"List messages\",\"description\":\"Returns a list of messages for a given thread.\",\"dateModified\":\"2026-01-07T07:53:42.257Z\",\"isPartOf\":{\"@id\":\"https://openai-hd4n6.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-messages#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-messages#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Assistants\",\"item\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-assistants\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List messages\",\"item\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-messages\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-messages#apireference\",\"headline\":\"List messages\",\"name\":\"List messages\",\"description\":\"Returns a list of messages for a given thread.\",\"url\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-messages\",\"mainEntityOfPage\":{\"@id\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-messages#webpage\"},\"dateModified\":\"2026-01-07T07:53:42.257Z\",\"publisher\":{\"@id\":\"https://openai-hd4n6.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://openai-hd4n6.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenAI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OpenAI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/assistants/list-messages.md","siteName":"OpenAI","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/docs/quickstart"}]},{"tab":"API reference","groups":[{"group":"API","pages":[{"title":"Create chat completion","href":"/docs/api/create-chat-completion"}]},{"group":"Assistants","pages":[{"title":"List assistants","deprecated":null,"version":null,"openapi":"api-definition.yaml get /assistants","href":"/api-reference/assistants/list-assistants"},{"title":"Create assistant","deprecated":null,"version":null,"openapi":"api-definition.yaml post /assistants","href":"/api-reference/assistants/create-assistant"},{"title":"Retrieve assistant","deprecated":null,"version":null,"openapi":"api-definition.yaml get /assistants/{assistant_id}","href":"/api-reference/assistants/retrieve-assistant"},{"title":"Modify assistant","deprecated":null,"version":null,"openapi":"api-definition.yaml post /assistants/{assistant_id}","href":"/api-reference/assistants/modify-assistant"},{"title":"Delete assistant","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /assistants/{assistant_id}","href":"/api-reference/assistants/delete-assistant"},{"title":"Create thread","deprecated":null,"version":null,"openapi":"api-definition.yaml post /threads","href":"/api-reference/assistants/create-thread"},{"title":"Create thread and run","deprecated":null,"version":null,"openapi":"api-definition.yaml post /threads/runs","href":"/api-reference/assistants/create-thread-and-run"},{"title":"Retrieve thread.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}","href":"/api-reference/assistants/retrieve-thread"},{"title":"Modify thread","deprecated":null,"version":null,"openapi":"api-definition.yaml post /threads/{thread_id}","href":"/api-reference/assistants/modify-thread"},{"title":"Delete thread","description":"Delete a thread.","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /threads/{thread_id}","href":"/api-reference/assistants/delete-thread"},{"title":"List messages","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}/messages","href":"/api-reference/assistants/list-messages"},{"title":"Create message","description":"Create a message.","deprecated":null,"version":null,"openapi":"api-definition.yaml post /threads/{thread_id}/messages","href":"/api-reference/assistants/create-message"},{"title":"Retrieve message","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}/messages/{message_id}","href":"/api-reference/assistants/retrieve-message"},{"title":"Modify message","deprecated":null,"version":null,"openapi":"api-definition.yaml post /threads/{thread_id}/messages/{message_id}","href":"/api-reference/assistants/modify-message"},{"title":"Delete message","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /threads/{thread_id}/messages/{message_id}","href":"/api-reference/assistants/delete-message"},{"title":"List runs","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}/runs","href":"/api-reference/assistants/list-runs"},{"title":"Create run","deprecated":null,"version":null,"openapi":"api-definition.yaml post /threads/{thread_id}/runs","href":"/api-reference/assistants/create-run"},{"title":"Retrieve run","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}/runs/{run_id}","href":"/api-reference/assistants/retrieve-run"},{"title":"Modify run","deprecated":null,"version":null,"openapi":"api-definition.yaml post /threads/{thread_id}/runs/{run_id}","href":"/api-reference/assistants/modify-run"},{"title":"Cancel run","deprecated":null,"version":null,"openapi":"api-definition.yaml post /threads/{thread_id}/runs/{run_id}/cancel","href":"/api-reference/assistants/cancel-run"},{"title":"List run steps","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}/runs/{run_id}/steps","href":"/api-reference/assistants/list-run-steps"},{"title":"Retrieve run step","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}/runs/{run_id}/steps/{step_id}","href":"/api-reference/assistants/retrieve-run-step"},{"title":"The run step object","deprecated":null,"version":null,"openapi":"api-definition.yaml post /threads/{thread_id}/runs/{run_id}/submit_tool_outputs","href":"/api-reference/assistants/the-run-step-object"}]},{"group":"Audio","pages":[{"title":"Generate speech","deprecated":null,"version":null,"openapi":"api-definition.yaml post /audio/speech","href":"/api-reference/audio/generate-speech"},{"title":"Create transcription","deprecated":null,"version":null,"openapi":"api-definition.yaml post /audio/transcriptions","href":"/api-reference/audio/create-transcription"},{"title":"Create translation","deprecated":null,"version":null,"openapi":"api-definition.yaml post /audio/translations","href":"/api-reference/audio/create-translation"}]},{"group":"Batch","pages":[{"title":"List batch","deprecated":null,"version":null,"openapi":"api-definition.yaml get /batches","href":"/api-reference/batch/list-batch"},{"title":"Create batch","deprecated":null,"version":null,"openapi":"api-definition.yaml post /batches","href":"/api-reference/batch/create-batch"},{"title":"Retrieve batch","deprecated":null,"version":null,"openapi":"api-definition.yaml get /batches/{batch_id}","href":"/api-reference/batch/retrieve-batch"},{"title":"Cancel batch","deprecated":null,"version":null,"openapi":"api-definition.yaml post /batches/{batch_id}/cancel","href":"/api-reference/batch/cancel-batch"}]},{"group":"Chat","pages":[{"title":"List Chat Completions","deprecated":null,"version":null,"openapi":"api-definition.yaml get /chat/completions","href":"/api-reference/chat/list-chat-completions"},{"title":"Create chat completion","deprecated":null,"version":null,"openapi":"api-definition.yaml post /chat/completions","href":"/api-reference/chat/create-chat-completion"},{"title":"Get chat completion","deprecated":null,"version":null,"openapi":"api-definition.yaml get /chat/completions/{completion_id}","href":"/api-reference/chat/get-chat-completion"},{"title":"Update chat completion","deprecated":null,"version":null,"openapi":"api-definition.yaml post /chat/completions/{completion_id}","href":"/api-reference/chat/update-chat-completion"},{"title":"Delete chat completion","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /chat/completions/{completion_id}","href":"/api-reference/chat/delete-chat-completion"},{"title":"Get chat messages","deprecated":null,"version":null,"openapi":"api-definition.yaml get /chat/completions/{completion_id}/messages","href":"/api-reference/chat/get-chat-messages"}]},{"group":"Completions","pages":[{"title":"Create completion","deprecated":null,"version":null,"openapi":"api-definition.yaml post /completions","href":"/api-reference/completions/create-completion"}]},{"group":"Embeddings","pages":[{"title":"Create embeddings","deprecated":null,"version":null,"openapi":"api-definition.yaml post /embeddings","href":"/api-reference/embeddings/create-embeddings"}]},{"group":"Evals","pages":[{"title":"List evals","deprecated":null,"version":null,"openapi":"api-definition.yaml get /evals","href":"/api-reference/evals/list-evals"},{"title":"Create eval","deprecated":null,"version":null,"openapi":"api-definition.yaml post /evals","href":"/api-reference/evals/create-eval"},{"title":"Get an eval","deprecated":null,"version":null,"openapi":"api-definition.yaml get /evals/{eval_id}","href":"/api-reference/evals/get-an-eval"},{"title":"Update an eval","deprecated":null,"version":null,"openapi":"api-definition.yaml post /evals/{eval_id}","href":"/api-reference/evals/update-an-eval"},{"title":"Delete an eval\n","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /evals/{eval_id}","href":"/api-reference/evals/delete-an-eval"},{"title":"Get eval runs","deprecated":null,"version":null,"openapi":"api-definition.yaml get /evals/{eval_id}/runs","href":"/api-reference/evals/get-eval-runs"},{"title":"Create eval run","deprecated":null,"version":null,"openapi":"api-definition.yaml post /evals/{eval_id}/runs","href":"/api-reference/evals/create-eval-run"},{"title":"Get an eval run","deprecated":null,"version":null,"openapi":"api-definition.yaml get /evals/{eval_id}/runs/{run_id}","href":"/api-reference/evals/get-an-eval-run"},{"title":"Cancel eval run","deprecated":null,"version":null,"openapi":"api-definition.yaml post /evals/{eval_id}/runs/{run_id}","href":"/api-reference/evals/cancel-eval-run"},{"title":"Delete an eval run.\n","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /evals/{eval_id}/runs/{run_id}","href":"/api-reference/evals/delete-an-eval-run"},{"title":"Get eval run output items","deprecated":null,"version":null,"openapi":"api-definition.yaml get /evals/{eval_id}/runs/{run_id}/output_items","href":"/api-reference/evals/get-eval-run-output-items"},{"title":"Get an output item of an eval run","deprecated":null,"version":null,"openapi":"api-definition.yaml get /evals/{eval_id}/runs/{run_id}/output_items/{output_item_id}","href":"/api-reference/evals/get-an-output-item-of-an-eval-run"}]},{"group":"Files","pages":[{"title":"Returns a list of files.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /files","href":"/api-reference/files/returns-a-list-of-files"},{"title":"Upload a file","deprecated":null,"version":null,"openapi":"api-definition.yaml post /files","href":"/api-reference/files/upload-a-file"},{"title":"Returns information about a specific file.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /files/{file_id}","href":"/api-reference/files/returns-information-about-a-specific-file"},{"title":"Delete a file.","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /files/{file_id}","href":"/api-reference/files/delete-a-file"},{"title":"Returns the contents of the specified file.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /files/{file_id}/content","href":"/api-reference/files/returns-the-contents-of-the-specified-file"}]},{"group":"Fine-tuning","pages":[{"title":"List checkpoint permissions","deprecated":null,"version":null,"openapi":"api-definition.yaml get /fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions","href":"/api-reference/fine-tuning/list-checkpoint-permissions"},{"title":"Create checkpoint permissions","deprecated":null,"version":null,"openapi":"api-definition.yaml post /fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions","href":"/api-reference/fine-tuning/create-checkpoint-permissions"},{"title":"Delete checkpoint permission","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions","href":"/api-reference/fine-tuning/delete-checkpoint-permission"},{"title":"List your organization's fine-tuning jobs\n","deprecated":null,"version":null,"openapi":"api-definition.yaml get /fine_tuning/jobs","href":"/api-reference/fine-tuning/list-your-organizations-fine-tuning-jobs"},{"title":"Create a fine-tuning job","deprecated":null,"version":null,"openapi":"api-definition.yaml post /fine_tuning/jobs","href":"/api-reference/fine-tuning/create-a-fine-tuning-job"},{"title":"Retrieve fine-tuning job","deprecated":null,"version":null,"openapi":"api-definition.yaml get /fine_tuning/jobs/{fine_tuning_job_id}","href":"/api-reference/fine-tuning/retrieve-fine-tuning-job"},{"title":"Immediately cancel a fine-tune job.\n","deprecated":null,"version":null,"openapi":"api-definition.yaml post /fine_tuning/jobs/{fine_tuning_job_id}/cancel","href":"/api-reference/fine-tuning/immediately-cancel-a-fine-tune-job"},{"title":"List checkpoints for a fine-tuning job.\n","deprecated":null,"version":null,"openapi":"api-definition.yaml get /fine_tuning/jobs/{fine_tuning_job_id}/checkpoints","href":"/api-reference/fine-tuning/list-checkpoints-for-a-fine-tuning-job"},{"title":"Get status updates for a fine-tuning job.\n","deprecated":null,"version":null,"openapi":"api-definition.yaml get /fine_tuning/jobs/{fine_tuning_job_id}/events","href":"/api-reference/fine-tuning/get-status-updates-for-a-fine-tuning-job"}]},{"group":"Images","pages":[{"title":"Create image edit","deprecated":null,"version":null,"openapi":"api-definition.yaml post /images/edits","href":"/api-reference/images/create-image-edit"},{"title":"Create image","deprecated":null,"version":null,"openapi":"api-definition.yaml post /images/generations","href":"/api-reference/images/create-image"},{"title":"Create image variation","deprecated":null,"version":null,"openapi":"api-definition.yaml post /images/variations","href":"/api-reference/images/create-image-variation"}]},{"group":"Models","pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"api-definition.yaml get /models","href":"/api-reference/models/list-models"},{"title":"Retrieve model","deprecated":null,"version":null,"openapi":"api-definition.yaml get /models/{model}","href":"/api-reference/models/retrieve-model"},{"title":"Delete a fine-tuned model","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /models/{model}","href":"/api-reference/models/delete-a-fine-tuned-model"}]},{"group":"Moderations","pages":[{"title":"Create moderation","deprecated":null,"version":null,"openapi":"api-definition.yaml post /moderations","href":"/api-reference/moderations/create-moderation"}]},{"group":"API Reference","pages":[{"title":"List organization API keys","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/admin_api_keys","href":"/api-reference/list-organization-api-keys"},{"title":"Create an organization admin API key","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/admin_api_keys","href":"/api-reference/create-an-organization-admin-api-key"},{"title":"Retrieve a single organization API key","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/admin_api_keys/{key_id}","href":"/api-reference/retrieve-a-single-organization-api-key"},{"title":"Delete an organization admin API key","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /organization/admin_api_keys/{key_id}","href":"/api-reference/delete-an-organization-admin-api-key"}]},{"group":"Audit Logs","pages":[{"title":"List audit logs","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/audit_logs","href":"/api-reference/audit-logs/list-audit-logs"}]},{"group":"Certificates","pages":[{"title":"List organization certificates","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/certificates","href":"/api-reference/certificates/list-organization-certificates"},{"title":"Upload certificate","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/certificates","href":"/api-reference/certificates/upload-certificate"},{"title":"Activate certificates for organization","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/certificates/activate","href":"/api-reference/certificates/activate-certificates-for-organization"},{"title":"Deactivate certificates for organization","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/certificates/deactivate","href":"/api-reference/certificates/deactivate-certificates-for-organization"},{"title":"Get certificate","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/certificates/{certificate_id}","href":"/api-reference/certificates/get-certificate"},{"title":"Modify certificate","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/certificates/{certificate_id}","href":"/api-reference/certificates/modify-certificate"},{"title":"Delete certificate","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /organization/certificates/{certificate_id}","href":"/api-reference/certificates/delete-certificate"},{"title":"List project certificates","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/projects/{project_id}/certificates","href":"/api-reference/certificates/list-project-certificates"},{"title":"Activate project certificates","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/projects/{project_id}/certificates/activate","href":"/api-reference/certificates/activate-project-certificates"},{"title":"Deactivate project certificates","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/projects/{project_id}/certificates/deactivate","href":"/api-reference/certificates/deactivate-project-certificates"}]},{"group":"Usage","pages":[{"title":"Costs","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/costs","href":"/api-reference/usage/costs"},{"title":"Audio speeches","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/usage/audio_speeches","href":"/api-reference/usage/audio-speeches"},{"title":"Audio transcriptions","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/usage/audio_transcriptions","href":"/api-reference/usage/audio-transcriptions"},{"title":"Code interpreter sessions","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/usage/code_interpreter_sessions","href":"/api-reference/usage/code-interpreter-sessions"},{"title":"Completions","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/usage/completions","href":"/api-reference/usage/completions"},{"title":"Embeddings","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/usage/embeddings","href":"/api-reference/usage/embeddings"},{"title":"Images","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/usage/images","href":"/api-reference/usage/images"},{"title":"Moderations","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/usage/moderations","href":"/api-reference/usage/moderations"},{"title":"Vector stores","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/usage/vector_stores","href":"/api-reference/usage/vector-stores"}]},{"group":"Invites","pages":[{"title":"List invites","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/invites","href":"/api-reference/invites/list-invites"},{"title":"Create invite","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/invites","href":"/api-reference/invites/create-invite"},{"title":"Retrieve invite","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/invites/{invite_id}","href":"/api-reference/invites/retrieve-invite"},{"title":"Delete invite","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /organization/invites/{invite_id}","href":"/api-reference/invites/delete-invite"}]},{"group":"Projects","pages":[{"title":"Returns a list of projects.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/projects","href":"/api-reference/projects/returns-a-list-of-projects"},{"title":"Create project","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/projects","href":"/api-reference/projects/create-project"},{"title":"Retrieves a project.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/projects/{project_id}","href":"/api-reference/projects/retrieves-a-project"},{"title":"Modify project","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/projects/{project_id}","href":"/api-reference/projects/modify-project"},{"title":"List project API keys","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/projects/{project_id}/api_keys","href":"/api-reference/projects/list-project-api-keys"},{"title":"Retrieve project API key","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/projects/{project_id}/api_keys/{key_id}","href":"/api-reference/projects/retrieve-project-api-key"},{"title":"Delete project API key","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /organization/projects/{project_id}/api_keys/{key_id}","href":"/api-reference/projects/delete-project-api-key"},{"title":"Archive project","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/projects/{project_id}/archive","href":"/api-reference/projects/archive-project"},{"title":"List project rate limits","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/projects/{project_id}/rate_limits","href":"/api-reference/projects/list-project-rate-limits"},{"title":"Update project rate limit","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/projects/{project_id}/rate_limits/{rate_limit_id}","href":"/api-reference/projects/update-project-rate-limit"},{"title":"List project service accounts","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/projects/{project_id}/service_accounts","href":"/api-reference/projects/list-project-service-accounts"},{"title":"Create project service account","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/projects/{project_id}/service_accounts","href":"/api-reference/projects/create-project-service-account"},{"title":"Retrieve project service account","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/projects/{project_id}/service_accounts/{service_account_id}","href":"/api-reference/projects/retrieve-project-service-account"},{"title":"Delete project service account","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /organization/projects/{project_id}/service_accounts/{service_account_id}","href":"/api-reference/projects/delete-project-service-account"},{"title":"Return project users","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/projects/{project_id}/users","href":"/api-reference/projects/return-project-users"},{"title":"Create project user","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/projects/{project_id}/users","href":"/api-reference/projects/create-project-user"},{"title":"Retrieve project user","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/projects/{project_id}/users/{user_id}","href":"/api-reference/projects/retrieve-project-user"},{"title":"Modify project user","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/projects/{project_id}/users/{user_id}","href":"/api-reference/projects/modify-project-user"},{"title":"Delete project user","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /organization/projects/{project_id}/users/{user_id}","href":"/api-reference/projects/delete-project-user"}]},{"group":"Users","pages":[{"title":"List users","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/users","href":"/api-reference/users/list-users"},{"title":"Retrieve user","deprecated":null,"version":null,"openapi":"api-definition.yaml get /organization/users/{user_id}","href":"/api-reference/users/retrieve-user"},{"title":"Modify user","deprecated":null,"version":null,"openapi":"api-definition.yaml post /organization/users/{user_id}","href":"/api-reference/users/modify-user"},{"title":"Delete user","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /organization/users/{user_id}","href":"/api-reference/users/delete-user"}]},{"group":"Realtime","pages":[{"title":"Create session","deprecated":null,"version":null,"openapi":"api-definition.yaml post /realtime/sessions","href":"/api-reference/realtime/create-session"},{"title":"Create transcription session","deprecated":null,"version":null,"openapi":"api-definition.yaml post /realtime/transcription_sessions","href":"/api-reference/realtime/create-transcription-session"}]},{"group":"Responses","pages":[{"title":"Create a model response","deprecated":null,"version":null,"openapi":"api-definition.yaml post /responses","href":"/api-reference/responses/create-a-model-response"},{"title":"Get a model response","deprecated":null,"version":null,"openapi":"api-definition.yaml get /responses/{response_id}","href":"/api-reference/responses/get-a-model-response"},{"title":"Delete a model response","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /responses/{response_id}","href":"/api-reference/responses/delete-a-model-response"},{"title":"List input items","deprecated":null,"version":null,"openapi":"api-definition.yaml get /responses/{response_id}/input_items","href":"/api-reference/responses/list-input-items"}]},{"group":"Uploads","pages":[{"title":"Create upload","deprecated":null,"version":null,"openapi":"api-definition.yaml post /uploads","href":"/api-reference/uploads/create-upload"},{"title":"Cancel upload","deprecated":null,"version":null,"openapi":"api-definition.yaml post /uploads/{upload_id}/cancel","href":"/api-reference/uploads/cancel-upload"},{"title":"Complete an upload","deprecated":null,"version":null,"openapi":"api-definition.yaml post /uploads/{upload_id}/complete","href":"/api-reference/uploads/complete-an-upload"},{"title":"Adds a Part to an Upload","deprecated":null,"version":null,"openapi":"api-definition.yaml post /uploads/{upload_id}/parts","href":"/api-reference/uploads/adds-a-part-to-an-upload"}]},{"group":"Vector stores","pages":[{"title":"Returns a list of vector stores.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /vector_stores","href":"/api-reference/vector-stores/returns-a-list-of-vector-stores"},{"title":"Create a vector store.","deprecated":null,"version":null,"openapi":"api-definition.yaml post /vector_stores","href":"/api-reference/vector-stores/create-a-vector-store"},{"title":"Retrieves a vector store.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /vector_stores/{vector_store_id}","href":"/api-reference/vector-stores/retrieves-a-vector-store"},{"title":"Modifies a vector store.","deprecated":null,"version":null,"openapi":"api-definition.yaml post /vector_stores/{vector_store_id}","href":"/api-reference/vector-stores/modifies-a-vector-store"},{"title":"Delete a vector store.","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /vector_stores/{vector_store_id}","href":"/api-reference/vector-stores/delete-a-vector-store"},{"title":"Create a vector store file batch.","deprecated":null,"version":null,"openapi":"api-definition.yaml post /vector_stores/{vector_store_id}/file_batches","href":"/api-reference/vector-stores/create-a-vector-store-file-batch"},{"title":"Retrieves a vector store file batch.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /vector_stores/{vector_store_id}/file_batches/{batch_id}","href":"/api-reference/vector-stores/retrieves-a-vector-store-file-batch"},{"title":"Cancel vector store file batch","deprecated":null,"version":null,"openapi":"api-definition.yaml post /vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel","href":"/api-reference/vector-stores/cancel-vector-store-file-batch"},{"title":"Returns a list of vector store files in a batch.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /vector_stores/{vector_store_id}/file_batches/{batch_id}/files","href":"/api-reference/vector-stores/returns-a-list-of-vector-store-files-in-a-batch"},{"title":"Returns a list of vector store files.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /vector_stores/{vector_store_id}/files","href":"/api-reference/vector-stores/returns-a-list-of-vector-store-files"},{"title":"Create vector store file","deprecated":null,"version":null,"openapi":"api-definition.yaml post /vector_stores/{vector_store_id}/files","href":"/api-reference/vector-stores/create-vector-store-file"},{"title":"Retrieves a vector store file.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /vector_stores/{vector_store_id}/files/{file_id}","href":"/api-reference/vector-stores/retrieves-a-vector-store-file"},{"title":"Update attributes on a vector store file.","deprecated":null,"version":null,"openapi":"api-definition.yaml post /vector_stores/{vector_store_id}/files/{file_id}","href":"/api-reference/vector-stores/update-attributes-on-a-vector-store-file"},{"title":"Delete vector store file","deprecated":null,"version":null,"openapi":"api-definition.yaml delete /vector_stores/{vector_store_id}/files/{file_id}","href":"/api-reference/vector-stores/delete-vector-store-file"},{"title":"Retrieve vector store","deprecated":null,"version":null,"openapi":"api-definition.yaml get /vector_stores/{vector_store_id}/files/{file_id}/content","href":"/api-reference/vector-stores/retrieve-vector-store"},{"title":"Search vector store","deprecated":null,"version":null,"openapi":"api-definition.yaml post /vector_stores/{vector_store_id}/search","href":"/api-reference/vector-stores/search-vector-store"}]}]}]},"basePath":"","title":"List messages - OpenAI","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-_HcdDqS2.js","snippetPresets-CXnm-WO6.js","utils-Dg59J__o.js","style-to-object-BY3JEAdk.js","utils-D8TRpdk7.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-B6QaxWc5.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DeMZ-lcM.js","_Uint8Array-BjA2mcVW.js","isObject-FP1Yky1u.js","Page-DuqezyvM.js","CodeSnippet-B373COAT.js","DynamicMarkdown-5yMTCLas.js","SectionHeading-BxT1HYfP.js","icon-DYJTTD3g.js","ApiExamples-cjPyMv63.js","usePlaygroundInputsStore-D7BWoaw4.js","shallow-Z1ceDNSG.js","isEqual-BObTuQrO.js","CodeSnippets-D1UZ1AE-.js","getApiPlaygroundDisplay-CfL-UuDS.js","MethodPill-4AyycJeu.js","getPastedJson-Bp3WV6cN.js","Check2Icon-PhZu6Gry.js","axios-CsQoIw0U.js","Markdown-Dy9a8hT8.js","AssistantPageLink-87tSPwGm.js","dist-CXMB3QQU.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}