Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
thread_id
string
required
The ID of the thread the run belongs to.
Query Parameters
limit
integer
default:20
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.
{"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-runs","slug":"/api-reference/assistants/list-runs","pageMetadata":{"title":"List runs","description":"Returns a list of runs belonging to a thread.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}/runs","href":"/api-reference/assistants/list-runs","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 runs belonging to a 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 runs","description":"Returns a list of runs belonging to a thread.","deprecated":null,"version":null,"openapi":"api-definition.yaml get /threads/{thread_id}/runs","href":"/api-reference/assistants/list-runs","autogeneratedByOpenApi":true,"hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"listRuns","tags":["Assistants"],"summary":"List runs","description":"Returns a list of runs belonging to a thread.","parameters":["cc7f16e4-2a74-4f32-9d68-30962ea34f31","11e7eae6-0e58-408c-85ef-f9dbd543b0d1","d3319cbb-bf6b-4d37-a45c-b826da387ad5","91fa5815-4301-4e6f-81a8-49be5e603e43","09c6eb08-de1f-4ed3-9f78-6f37629574ac"],"responses":{"200":"1553828b-7c96-4574-9683-1ab065e6530c"},"x-oaiMeta":{"name":"List runs","group":"threads","beta":true,"returns":"A list of [run](/docs/api-reference/runs/object) objects.","examples":{"request":{"curl":"curl https://api.openai.com/v1/threads/thread_abc123/runs \\\n -H \"Authorization: Bearer $OPENAI_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"OpenAI-Beta: assistants=v2\"\n","python":"from openai import OpenAI\nclient = OpenAI()\n\nruns = client.beta.threads.runs.list(\n \"thread_abc123\"\n)\n\nprint(runs)\n","node.js":"import OpenAI from \"openai\";\n\nconst openai = new OpenAI();\n\nasync function main() {\n const runs = await openai.beta.threads.runs.list(\n \"thread_abc123\"\n );\n\n console.log(runs);\n}\n\nmain();\n"},"response":"{\n \"object\": \"list\",\n \"data\": [\n {\n \"id\": \"run_abc123\",\n \"object\": \"thread.run\",\n \"created_at\": 1699075072,\n \"assistant_id\": \"asst_abc123\",\n \"thread_id\": \"thread_abc123\",\n \"status\": \"completed\",\n \"started_at\": 1699075072,\n \"expires_at\": null,\n \"cancelled_at\": null,\n \"failed_at\": null,\n \"completed_at\": 1699075073,\n \"last_error\": null,\n \"model\": \"gpt-4o\",\n \"instructions\": null,\n \"incomplete_details\": null,\n \"tools\": [\n {\n \"type\": \"code_interpreter\"\n }\n ],\n \"tool_resources\": {\n \"code_interpreter\": {\n \"file_ids\": [\n \"file-abc123\",\n \"file-abc456\"\n ]\n }\n },\n \"metadata\": {},\n \"usage\": {\n \"prompt_tokens\": 123,\n \"completion_tokens\": 456,\n \"total_tokens\": 579\n },\n \"temperature\": 1.0,\n \"top_p\": 1.0,\n \"max_prompt_tokens\": 1000,\n \"max_completion_tokens\": 1000,\n \"truncation_strategy\": {\n \"type\": \"auto\",\n \"last_messages\": null\n },\n \"response_format\": \"auto\",\n \"tool_choice\": \"auto\",\n \"parallel_tool_calls\": true\n },\n {\n \"id\": \"run_abc456\",\n \"object\": \"thread.run\",\n \"created_at\": 1699063290,\n \"assistant_id\": \"asst_abc123\",\n \"thread_id\": \"thread_abc123\",\n \"status\": \"completed\",\n \"started_at\": 1699063290,\n \"expires_at\": null,\n \"cancelled_at\": null,\n \"failed_at\": null,\n \"completed_at\": 1699063291,\n \"last_error\": null,\n \"model\": \"gpt-4o\",\n \"instructions\": null,\n \"incomplete_details\": null,\n \"tools\": [\n {\n \"type\": \"code_interpreter\"\n }\n ],\n \"tool_resources\": {\n \"code_interpreter\": {\n \"file_ids\": [\n \"file-abc123\",\n \"file-abc456\"\n ]\n }\n },\n \"metadata\": {},\n \"usage\": {\n \"prompt_tokens\": 123,\n \"completion_tokens\": 456,\n \"total_tokens\": 579\n },\n \"temperature\": 1.0,\n \"top_p\": 1.0,\n \"max_prompt_tokens\": 1000,\n \"max_completion_tokens\": 1000,\n \"truncation_strategy\": {\n \"type\": \"auto\",\n \"last_messages\": null\n },\n \"response_format\": \"auto\",\n \"tool_choice\": \"auto\",\n \"parallel_tool_calls\": true\n }\n ],\n \"first_id\": \"run_abc123\",\n \"last_id\": \"run_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}/runs","baseUrlOptions":["https://api.openai.com/v1"],"title":"List runs","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"cc7f16e4-2a74-4f32-9d68-30962ea34f31":{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"The ID of the thread the run belongs to.","uniqueKey":"","typeLabel":"string"},"description":"The ID of the thread the run belongs to."},"11e7eae6-0e58-408c-85ef-f9dbd543b0d1":{"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"}},"d3319cbb-bf6b-4d37-a45c-b826da387ad5":{"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>"}},"91fa5815-4301-4e6f-81a8-49be5e603e43":{"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"}},"09c6eb08-de1f-4ed3-9f78-6f37629574ac":{"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"}}},"responses":{"1553828b-7c96-4574-9683-1ab065e6530c":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","example":"list","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"data":{"type":"array","items":{"type":"object","title":"A run on a thread","description":"Represents an execution run on 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.run`.","type":"string","enum":["thread.run"],"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 run was created.","type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].created_at","typeLabel":"integer"},"thread_id":{"description":"The ID of the [thread](/docs/api-reference/threads) that was executed on as a part of this run.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].thread_id","typeLabel":"string"},"assistant_id":{"description":"The ID of the [assistant](/docs/api-reference/assistants) used for execution of this run.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].assistant_id","typeLabel":"string"},"status":{"description":"The status of the run, which can be either `queued`, `in_progress`, `requires_action`, `cancelling`, `cancelled`, `failed`, `completed`, `incomplete`, or `expired`.","type":"string","enum":["queued","in_progress","requires_action","cancelling","cancelled","failed","completed","incomplete","expired"],"isRequired":true,"uniqueKey":"data.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"required_action":{"oneOf":[{"type":"object","description":"Details on the action required to continue the run. Will be `null` if no action is required.","properties":{"type":{"description":"For now, this is always `submit_tool_outputs`.","type":"string","enum":["submit_tool_outputs"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].required_action.oneOf.0.type","typeLabel":"enum\u003cstring>"},"submit_tool_outputs":{"type":"object","description":"Details on the tool outputs needed for this run to continue.","properties":{"tool_calls":{"type":"array","description":"A list of the relevant tool calls.","items":{"type":"object","description":"Tool call objects","properties":{"id":{"type":"string","description":"The ID of the tool call. This ID must be referenced when you submit the tool outputs in using the [Submit tool outputs to run](/docs/api-reference/runs/submitToolOutputs) endpoint.","isRequired":true,"uniqueKey":"data.items.[INDEX].required_action.oneOf.0.submit_tool_outputs.tool_calls.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","description":"The type of tool call the output is required for. For now, this is always `function`.","enum":["function"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].required_action.oneOf.0.submit_tool_outputs.tool_calls.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"function":{"type":"object","description":"The function definition.","properties":{"name":{"type":"string","description":"The name of the function.","isRequired":true,"uniqueKey":"data.items.[INDEX].required_action.oneOf.0.submit_tool_outputs.tool_calls.items.[INDEX].function.name","typeLabel":"string"},"arguments":{"type":"string","description":"The arguments that the model expects you to pass to the function.","isRequired":true,"uniqueKey":"data.items.[INDEX].required_action.oneOf.0.submit_tool_outputs.tool_calls.items.[INDEX].function.arguments","typeLabel":"string"}},"required":["name","arguments"],"isRequired":true,"uniqueKey":"data.items.[INDEX].required_action.oneOf.0.submit_tool_outputs.tool_calls.items.[INDEX].function","typeLabel":"object"}},"required":["id","type","function"],"uniqueKey":"data.items.[INDEX].required_action.oneOf.0.submit_tool_outputs.tool_calls.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].required_action.oneOf.0.submit_tool_outputs.tool_calls","typeLabel":"object[]"}},"required":["tool_calls"],"isRequired":true,"uniqueKey":"data.items.[INDEX].required_action.oneOf.0.submit_tool_outputs","typeLabel":"object"}},"required":["type","submit_tool_outputs"],"isRequired":true,"uniqueKey":"data.items.[INDEX].required_action.oneOf.0","typeLabel":"object"},{"type":"null","description":"Details on the action required to continue the run. Will be `null` if no action is required.","properties":{"type":{"description":"For now, this is always `submit_tool_outputs`.","type":"string","enum":["submit_tool_outputs"],"x-stainless-const":true},"submit_tool_outputs":{"type":"object","description":"Details on the tool outputs needed for this run to continue.","properties":{"tool_calls":{"type":"array","description":"A list of the relevant tool calls.","items":{"type":"object","description":"Tool call objects","properties":{"id":{"type":"string","description":"The ID of the tool call. This ID must be referenced when you submit the tool outputs in using the [Submit tool outputs to run](/docs/api-reference/runs/submitToolOutputs) endpoint."},"type":{"type":"string","description":"The type of tool call the output is required for. For now, this is always `function`.","enum":["function"],"x-stainless-const":true},"function":{"type":"object","description":"The function definition.","properties":{"name":{"type":"string","description":"The name of the function."},"arguments":{"type":"string","description":"The arguments that the model expects you to pass to the function."}},"required":["name","arguments"]}},"required":["id","type","function"]}}},"required":["tool_calls"]}},"required":["type","submit_tool_outputs"],"isRequired":true,"uniqueKey":"data.items.[INDEX].required_action.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].required_action","typeLabel":"object | null"},"last_error":{"oneOf":[{"type":"object","description":"The last error associated with this run. Will be `null` if there are no errors.","properties":{"code":{"type":"string","description":"One of `server_error`, `rate_limit_exceeded`, or `invalid_prompt`.","enum":["server_error","rate_limit_exceeded","invalid_prompt"],"isRequired":true,"uniqueKey":"data.items.[INDEX].last_error.oneOf.0.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"data.items.[INDEX].last_error.oneOf.0.message","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"data.items.[INDEX].last_error.oneOf.0","typeLabel":"object"},{"type":"null","description":"The last error associated with this run. Will be `null` if there are no errors.","properties":{"code":{"type":"string","description":"One of `server_error`, `rate_limit_exceeded`, or `invalid_prompt`.","enum":["server_error","rate_limit_exceeded","invalid_prompt"]},"message":{"type":"string","description":"A human-readable description of the error."}},"required":["code","message"],"isRequired":true,"uniqueKey":"data.items.[INDEX].last_error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].last_error","typeLabel":"object | null"},"expires_at":{"oneOf":[{"description":"The Unix timestamp (in seconds) for when the run will expire.","type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].expires_at.oneOf.0","typeLabel":"integer"},{"description":"The Unix timestamp (in seconds) for when the run will expire.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].expires_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].expires_at","typeLabel":"integer | null"},"started_at":{"oneOf":[{"description":"The Unix timestamp (in seconds) for when the run was started.","type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].started_at.oneOf.0","typeLabel":"integer"},{"description":"The Unix timestamp (in seconds) for when the run was started.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].started_at","typeLabel":"integer | null"},"cancelled_at":{"oneOf":[{"description":"The Unix timestamp (in seconds) for when the run was cancelled.","type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].cancelled_at.oneOf.0","typeLabel":"integer"},{"description":"The Unix timestamp (in seconds) for when the run was cancelled.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].cancelled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].cancelled_at","typeLabel":"integer | null"},"failed_at":{"oneOf":[{"description":"The Unix timestamp (in seconds) for when the run failed.","type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].failed_at.oneOf.0","typeLabel":"integer"},{"description":"The Unix timestamp (in seconds) for when the run failed.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].failed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].failed_at","typeLabel":"integer | null"},"completed_at":{"oneOf":[{"description":"The Unix timestamp (in seconds) for when the run 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 run 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_details":{"oneOf":[{"description":"Details on why the run is incomplete. Will be `null` if the run is not incomplete.","type":"object","properties":{"reason":{"description":"The reason why the run is incomplete. This will point to which specific token limit was reached over the course of the run.","type":"string","enum":["max_completion_tokens","max_prompt_tokens"],"uniqueKey":"data.items.[INDEX].incomplete_details.oneOf.0.reason","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete_details.oneOf.0","typeLabel":"object"},{"description":"Details on why the run is incomplete. Will be `null` if the run is not incomplete.","type":"null","properties":{"reason":{"description":"The reason why the run is incomplete. This will point to which specific token limit was reached over the course of the run.","type":"string","enum":["max_completion_tokens","max_prompt_tokens"]}},"isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete_details.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].incomplete_details","typeLabel":"object | null"},"model":{"description":"The model that the [assistant](/docs/api-reference/assistants) used for this run.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].model","typeLabel":"string"},"instructions":{"description":"The instructions that the [assistant](/docs/api-reference/assistants) used for this run.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].instructions","typeLabel":"string"},"tools":{"description":"The list of tools that the [assistant](/docs/api-reference/assistants) used for this run.","default":[],"type":"array","maxItems":20,"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].tools.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.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].tools.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"file_search":{"type":"object","description":"Overrides for the file search tool.","properties":{"max_num_results":{"type":"integer","minimum":1,"maximum":50,"description":"The maximum number of results the file search tool should output. The default is 20 for `gpt-4*` models and 5 for `gpt-3.5-turbo`. This number should be between 1 and 50 inclusive.\n\nNote that the file search tool may output fewer than `max_num_results` results. See the [file search tool documentation](/docs/assistants/tools/file-search#customizing-file-search-settings) for more information.\n","uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.1.file_search.max_num_results","typeLabel":"integer"},"ranking_options":{"title":"File search tool call ranking options","type":"object","description":"The ranking options for the file search. If not specified, the file search tool will use the `auto` ranker and a score_threshold of 0.\n\nSee the [file search tool documentation](/docs/assistants/tools/file-search#customizing-file-search-settings) for more information.\n","properties":{"score_threshold":{"type":"number","description":"The score threshold for the file search. All values must be a floating point number between 0 and 1.","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.1.file_search.ranking_options.score_threshold","typeLabel":"number"},"ranker":{"type":"string","description":"The ranker to use for the file search. If not specified will use the `auto` ranker.","enum":["auto","default_2024_08_21"],"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.1.file_search.ranking_options.ranker","typeLabel":"enum\u003cstring>"}},"required":["score_threshold"],"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.1.file_search.ranking_options","typeLabel":"File search tool call ranking options · object"}},"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.1.file_search","typeLabel":"object"}},"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.1","typeLabel":"FileSearch tool · object"},{"type":"object","title":"Function tool","required":["type","function"],"x-oaiExpandable":true,"properties":{"type":{"type":"string","description":"The type of tool being defined: `function`","enum":["function"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"function":{"type":"object","properties":{"name":{"type":"string","description":"The name of the function to be called. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64.","isRequired":true,"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.2.function.name","typeLabel":"string"},"description":{"type":"string","description":"A description of what the function does, used by the model to choose when and how to call the function.","uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.2.function.description","typeLabel":"string"},"parameters":{"type":"object","description":"The parameters the functions accepts, described as a JSON Schema object. See the [guide](/docs/guides/function-calling) for examples, and the [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for documentation about the format. \n\nOmitting `parameters` defines a function with an empty parameter list.","additionalProperties":true,"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.2.function.parameters","typeLabel":"object"},"strict":{"oneOf":[{"type":"boolean","default":false,"description":"Whether to enable strict schema adherence when generating the function call. If set to true, the model will follow the exact schema defined in the `parameters` field. Only a subset of JSON Schema is supported when `strict` is `true`. Learn more about Structured Outputs in the [function calling guide](docs/guides/function-calling).","uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.2.function.strict.oneOf.0","typeLabel":"boolean"},{"type":"null","default":false,"description":"Whether to enable strict schema adherence when generating the function call. If set to true, the model will follow the exact schema defined in the `parameters` field. Only a subset of JSON Schema is supported when `strict` is `true`. Learn more about Structured Outputs in the [function calling guide](docs/guides/function-calling).","uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.2.function.strict.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.2.function.strict","typeLabel":"boolean | null"}},"required":["name"],"isRequired":true,"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.2.function","typeLabel":"object"}},"uniqueKey":"data.items.[INDEX].tools.items.[INDEX].oneOf.2","typeLabel":"Function tool · object"}],"uniqueKey":"data.items.[INDEX].tools.items.[INDEX]","typeLabel":"Code interpreter tool · object | FileSearch tool · object | Function tool · object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].tools","typeLabel":"(Code interpreter tool · object | FileSearch tool · object | Function tool · object)[]"},"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"},"usage":{"oneOf":[{"type":"object","description":"Usage statistics related to the run. This value will be `null` if the run is not in a terminal state (i.e. `in_progress`, `queued`, etc.).","properties":{"completion_tokens":{"type":"integer","description":"Number of completion tokens used over the course of the run.","isRequired":true,"uniqueKey":"data.items.[INDEX].usage.oneOf.0.completion_tokens","typeLabel":"integer"},"prompt_tokens":{"type":"integer","description":"Number of prompt tokens used over the course of the run.","isRequired":true,"uniqueKey":"data.items.[INDEX].usage.oneOf.0.prompt_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","description":"Total number of tokens used (prompt + completion).","isRequired":true,"uniqueKey":"data.items.[INDEX].usage.oneOf.0.total_tokens","typeLabel":"integer"}},"required":["prompt_tokens","completion_tokens","total_tokens"],"isRequired":true,"uniqueKey":"data.items.[INDEX].usage.oneOf.0","typeLabel":"object"},{"type":"null","description":"Usage statistics related to the run. This value will be `null` if the run is not in a terminal state (i.e. `in_progress`, `queued`, etc.).","properties":{"completion_tokens":{"type":"integer","description":"Number of completion tokens used over the course of the run."},"prompt_tokens":{"type":"integer","description":"Number of prompt tokens used over the course of the run."},"total_tokens":{"type":"integer","description":"Total number of tokens used (prompt + completion)."}},"required":["prompt_tokens","completion_tokens","total_tokens"],"isRequired":true,"uniqueKey":"data.items.[INDEX].usage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].usage","typeLabel":"object | null"},"max_prompt_tokens":{"oneOf":[{"type":"integer","description":"The maximum number of prompt tokens specified to have been used over the course of the run.\n","minimum":256,"isRequired":true,"uniqueKey":"data.items.[INDEX].max_prompt_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The maximum number of prompt tokens specified to have been used over the course of the run.\n","minimum":256,"isRequired":true,"uniqueKey":"data.items.[INDEX].max_prompt_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].max_prompt_tokens","typeLabel":"integer | null"},"max_completion_tokens":{"oneOf":[{"type":"integer","description":"The maximum number of completion tokens specified to have been used over the course of the run.\n","minimum":256,"isRequired":true,"uniqueKey":"data.items.[INDEX].max_completion_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The maximum number of completion tokens specified to have been used over the course of the run.\n","minimum":256,"isRequired":true,"uniqueKey":"data.items.[INDEX].max_completion_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].max_completion_tokens","typeLabel":"integer | null"},"truncation_strategy":{"type":"object","title":"Thread Truncation Controls","description":"Controls for how a thread will be truncated prior to the run. Use this to control the intial context window of the run.","required":["type"],"properties":{"type":{"type":"string","description":"The truncation strategy to use for the thread. The default is `auto`. If set to `last_messages`, the thread will be truncated to the n most recent messages in the thread. When set to `auto`, messages in the middle of the thread will be dropped to fit the context length of the model, `max_prompt_tokens`.","enum":["auto","last_messages"],"isRequired":true,"uniqueKey":"data.items.[INDEX].truncation_strategy.type","typeLabel":"enum\u003cstring>"},"last_messages":{"oneOf":[{"type":"integer","description":"The number of most recent messages from the thread when constructing the context for the run.","minimum":1,"uniqueKey":"data.items.[INDEX].truncation_strategy.last_messages.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The number of most recent messages from the thread when constructing the context for the run.","minimum":1,"uniqueKey":"data.items.[INDEX].truncation_strategy.last_messages.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].truncation_strategy.last_messages","typeLabel":"integer | null"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].truncation_strategy","typeLabel":"Thread Truncation Controls · object"},"tool_choice":{"oneOf":[{"type":"string","description":"Controls which (if any) tool is called by the model.\n`none` means the model will not call any tools and instead generates a message.\n`auto` is the default value and means the model can pick between generating a message or calling one or more tools.\n`required` means the model must call one or more tools before responding to the user.\nSpecifying a particular tool like `{\"type\": \"file_search\"}` or `{\"type\": \"function\", \"function\": {\"name\": \"my_function\"}}` forces the model to call that tool.\n","enum":["none","auto","required"],"x-oaiExpandable":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].tool_choice.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"Controls which (if any) tool is called by the model.\n`none` means the model will not call any tools and instead generates a message.\n`auto` is the default value and means the model can pick between generating a message or calling one or more tools.\n`required` means the model must call one or more tools before responding to the user.\nSpecifying a particular tool like `{\"type\": \"file_search\"}` or `{\"type\": \"function\", \"function\": {\"name\": \"my_function\"}}` forces the model to call that tool.\n","required":["type"],"x-oaiExpandable":true,"properties":{"type":{"type":"string","enum":["function","code_interpreter","file_search"],"description":"The type of the tool. If type is `function`, the function name must be set","isRequired":true,"uniqueKey":"data.items.[INDEX].tool_choice.oneOf.1.type","typeLabel":"enum\u003cstring>"},"function":{"type":"object","properties":{"name":{"type":"string","description":"The name of the function to call.","isRequired":true,"uniqueKey":"data.items.[INDEX].tool_choice.oneOf.1.function.name","typeLabel":"string"}},"required":["name"],"uniqueKey":"data.items.[INDEX].tool_choice.oneOf.1.function","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].tool_choice.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].tool_choice","typeLabel":"enum\u003cstring> | object"},"parallel_tool_calls":{"description":"Whether to enable [parallel function calling](/docs/guides/function-calling#configuring-parallel-function-calling) during tool use.","type":"boolean","default":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].parallel_tool_calls","typeLabel":"boolean"},"response_format":{"oneOf":[{"type":"string","description":"Specifies the format that the model must output. Compatible with [GPT-4o](/docs/models#gpt-4o), [GPT-4 Turbo](/docs/models#gpt-4-turbo-and-gpt-4), and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.\n\nSetting to `{ \"type\": \"json_schema\", \"json_schema\": {...} }` enables Structured Outputs which ensures the model will match your supplied JSON schema. Learn more in the [Structured Outputs guide](/docs/guides/structured-outputs).\n\nSetting to `{ \"type\": \"json_object\" }` enables JSON mode, which ensures the message the model generates is valid JSON.\n\n**Important:** when using JSON mode, you **must** also instruct the model to produce JSON yourself via a system or user message. Without this, the model may generate an unending stream of whitespace until the generation reaches the token limit, resulting in a long-running and seemingly \"stuck\" request. Also note that the message content may be partially cut off if `finish_reason=\"length\"`, which indicates the generation exceeded `max_tokens` or the conversation exceeded the max context length.\n","enum":["auto"],"x-stainless-const":true,"x-oaiExpandable":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","title":"Text","description":"Specifies the format that the model must output. Compatible with [GPT-4o](/docs/models#gpt-4o), [GPT-4 Turbo](/docs/models#gpt-4-turbo-and-gpt-4), and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.\n\nSetting to `{ \"type\": \"json_schema\", \"json_schema\": {...} }` enables Structured Outputs which ensures the model will match your supplied JSON schema. Learn more in the [Structured Outputs guide](/docs/guides/structured-outputs).\n\nSetting to `{ \"type\": \"json_object\" }` enables JSON mode, which ensures the message the model generates is valid JSON.\n\n**Important:** when using JSON mode, you **must** also instruct the model to produce JSON yourself via a system or user message. Without this, the model may generate an unending stream of whitespace until the generation reaches the token limit, resulting in a long-running and seemingly \"stuck\" request. Also note that the message content may be partially cut off if `finish_reason=\"length\"`, which indicates the generation exceeded `max_tokens` or the conversation exceeded the max context length.\n","required":["type"],"x-oaiExpandable":true,"properties":{"type":{"type":"string","description":"The type of response format being defined. Always `text`.","enum":["text"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.1","typeLabel":"Text · object"},{"type":"object","title":"JSON object","description":"Specifies the format that the model must output. Compatible with [GPT-4o](/docs/models#gpt-4o), [GPT-4 Turbo](/docs/models#gpt-4-turbo-and-gpt-4), and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.\n\nSetting to `{ \"type\": \"json_schema\", \"json_schema\": {...} }` enables Structured Outputs which ensures the model will match your supplied JSON schema. Learn more in the [Structured Outputs guide](/docs/guides/structured-outputs).\n\nSetting to `{ \"type\": \"json_object\" }` enables JSON mode, which ensures the message the model generates is valid JSON.\n\n**Important:** when using JSON mode, you **must** also instruct the model to produce JSON yourself via a system or user message. Without this, the model may generate an unending stream of whitespace until the generation reaches the token limit, resulting in a long-running and seemingly \"stuck\" request. Also note that the message content may be partially cut off if `finish_reason=\"length\"`, which indicates the generation exceeded `max_tokens` or the conversation exceeded the max context length.\n","required":["type"],"x-oaiExpandable":true,"properties":{"type":{"type":"string","description":"The type of response format being defined. Always `json_object`.","enum":["json_object"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.2.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.2","typeLabel":"JSON object · object"},{"type":"object","title":"JSON schema","description":"Specifies the format that the model must output. Compatible with [GPT-4o](/docs/models#gpt-4o), [GPT-4 Turbo](/docs/models#gpt-4-turbo-and-gpt-4), and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.\n\nSetting to `{ \"type\": \"json_schema\", \"json_schema\": {...} }` enables Structured Outputs which ensures the model will match your supplied JSON schema. Learn more in the [Structured Outputs guide](/docs/guides/structured-outputs).\n\nSetting to `{ \"type\": \"json_object\" }` enables JSON mode, which ensures the message the model generates is valid JSON.\n\n**Important:** when using JSON mode, you **must** also instruct the model to produce JSON yourself via a system or user message. Without this, the model may generate an unending stream of whitespace until the generation reaches the token limit, resulting in a long-running and seemingly \"stuck\" request. Also note that the message content may be partially cut off if `finish_reason=\"length\"`, which indicates the generation exceeded `max_tokens` or the conversation exceeded the max context length.\n","required":["type","json_schema"],"x-oaiExpandable":true,"properties":{"type":{"type":"string","description":"The type of response format being defined. Always `json_schema`.","enum":["json_schema"],"x-stainless-const":true,"isRequired":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.3.type","typeLabel":"enum\u003cstring>"},"json_schema":{"type":"object","title":"JSON schema","description":"Structured Outputs configuration options, including a JSON Schema.\n","properties":{"name":{"type":"string","description":"The name of the response format. Must be a-z, A-Z, 0-9, or contain\nunderscores and dashes, with a maximum length of 64.\n","isRequired":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.3.json_schema.name","typeLabel":"string"},"description":{"type":"string","description":"A description of what the response format is for, used by the model to\ndetermine how to respond in the format.\n","uniqueKey":"data.items.[INDEX].response_format.oneOf.3.json_schema.description","typeLabel":"string"},"schema":{"type":"object","title":"JSON schema","description":"The schema for the response format, described as a JSON Schema object.\nLearn how to build JSON schemas [here](https://json-schema.org/).\n","additionalProperties":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.3.json_schema.schema","typeLabel":"JSON schema · object"},"strict":{"oneOf":[{"type":"boolean","default":false,"description":"Whether to enable strict schema adherence when generating the output.\nIf set to true, the model will always follow the exact schema defined\nin the `schema` field. Only a subset of JSON Schema is supported when\n`strict` is `true`. To learn more, read the [Structured Outputs\nguide](/docs/guides/structured-outputs).\n","uniqueKey":"data.items.[INDEX].response_format.oneOf.3.json_schema.strict.oneOf.0","typeLabel":"boolean"},{"type":"null","default":false,"description":"Whether to enable strict schema adherence when generating the output.\nIf set to true, the model will always follow the exact schema defined\nin the `schema` field. Only a subset of JSON Schema is supported when\n`strict` is `true`. To learn more, read the [Structured Outputs\nguide](/docs/guides/structured-outputs).\n","uniqueKey":"data.items.[INDEX].response_format.oneOf.3.json_schema.strict.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].response_format.oneOf.3.json_schema.strict","typeLabel":"boolean | null"}},"required":["name"],"isRequired":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.3.json_schema","typeLabel":"JSON schema · object"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.3","typeLabel":"JSON schema · object"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].response_format.oneOf.4","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].response_format","typeLabel":"enum\u003cstring> | Text · object | JSON object · object | JSON schema · object | null"},"temperature":{"oneOf":[{"description":"The sampling temperature used for this run. If not set, defaults to 1.","type":"number","uniqueKey":"data.items.[INDEX].temperature.oneOf.0","typeLabel":"number"},{"description":"The sampling temperature used for this run. If not set, defaults to 1.","type":"null","uniqueKey":"data.items.[INDEX].temperature.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].temperature","typeLabel":"number | null"},"top_p":{"oneOf":[{"description":"The nucleus sampling value used for this run. If not set, defaults to 1.","type":"number","uniqueKey":"data.items.[INDEX].top_p.oneOf.0","typeLabel":"number"},{"description":"The nucleus sampling value used for this run. If not set, defaults to 1.","type":"null","uniqueKey":"data.items.[INDEX].top_p.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].top_p","typeLabel":"number | null"}},"required":["id","object","created_at","thread_id","assistant_id","status","required_action","last_error","expires_at","started_at","cancelled_at","failed_at","completed_at","model","instructions","tools","metadata","usage","incomplete_details","max_prompt_tokens","max_completion_tokens","truncation_strategy","tool_choice","parallel_tool_calls","response_format"],"x-oaiMeta":{"name":"The run object","beta":true,"example":"{\n \"id\": \"run_abc123\",\n \"object\": \"thread.run\",\n \"created_at\": 1698107661,\n \"assistant_id\": \"asst_abc123\",\n \"thread_id\": \"thread_abc123\",\n \"status\": \"completed\",\n \"started_at\": 1699073476,\n \"expires_at\": null,\n \"cancelled_at\": null,\n \"failed_at\": null,\n \"completed_at\": 1699073498,\n \"last_error\": null,\n \"model\": \"gpt-4o\",\n \"instructions\": null,\n \"tools\": [{\"type\": \"file_search\"}, {\"type\": \"code_interpreter\"}],\n \"metadata\": {},\n \"incomplete_details\": null,\n \"usage\": {\n \"prompt_tokens\": 123,\n \"completion_tokens\": 456,\n \"total_tokens\": 579\n },\n \"temperature\": 1.0,\n \"top_p\": 1.0,\n \"max_prompt_tokens\": 1000,\n \"max_completion_tokens\": 1000,\n \"truncation_strategy\": {\n \"type\": \"auto\",\n \"last_messages\": null\n },\n \"response_format\": \"auto\",\n \"tool_choice\": \"auto\",\n \"parallel_tool_calls\": true\n}\n"},"uniqueKey":"data.items.[INDEX]","typeLabel":"A run on a thread · object"},"isRequired":true,"uniqueKey":"data","typeLabel":"A run on a thread · object[]"},"first_id":{"type":"string","example":"run_abc123","isRequired":true,"uniqueKey":"first_id","typeLabel":"string"},"last_id":{"type":"string","example":"run_abc456","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"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"list","data":[{"id":"\u003cstring>","object":"thread.run","created_at":123,"thread_id":"\u003cstring>","assistant_id":"\u003cstring>","status":"queued","required_action":{"type":"submit_tool_outputs","submit_tool_outputs":{"tool_calls":[{"id":"\u003cstring>","type":"function","function":{"name":"\u003cstring>","arguments":"\u003cstring>"}}]}},"last_error":{"code":"server_error","message":"\u003cstring>"},"expires_at":123,"started_at":123,"cancelled_at":123,"failed_at":123,"completed_at":123,"incomplete_details":{"reason":"max_completion_tokens"},"model":"\u003cstring>","instructions":"\u003cstring>","tools":[],"metadata":{},"usage":{"completion_tokens":123,"prompt_tokens":123,"total_tokens":123},"max_prompt_tokens":257,"max_completion_tokens":257,"truncation_strategy":{"type":"auto","last_messages":2},"tool_choice":"none","parallel_tool_calls":true,"response_format":"auto","temperature":123,"top_p":123}],"first_id":"run_abc123","last_id":"run_abc456","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 runs - OpenAI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T07:53:42.309Z","originalFileLocation":"api-reference/assistants/list-runs.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 runs belonging to a 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 runs - OpenAI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a list of runs belonging to a 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-runs\">\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+runs\u0026amp;description=Returns+a+list+of+runs+belonging+to+a+thread.\u0026amp;theme=7b37e8ffcf4d9c1fcde78b1c\u0026amp;signature=c156afa0dd140adcc354ea881715c620caf96b1420f5dd29341bb738108200b0\">\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 runs - OpenAI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a list of runs belonging to a thread.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openai-hd4n6.mintlify.site/_mintlify/api/og/v2?division=Assistants\u0026amp;title=List+runs\u0026amp;description=Returns+a+list+of+runs+belonging+to+a+thread.\u0026amp;theme=7b37e8ffcf4d9c1fcde78b1c\u0026amp;signature=c156afa0dd140adcc354ea881715c620caf96b1420f5dd29341bb738108200b0\">\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-runs\">\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-runs.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-runs#webpage\",\"url\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-runs\",\"name\":\"List runs\",\"description\":\"Returns a list of runs belonging to a thread.\",\"dateModified\":\"2026-01-07T07:53:42.309Z\",\"isPartOf\":{\"@id\":\"https://openai-hd4n6.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-runs#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-runs#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 runs\",\"item\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-runs\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-runs#apireference\",\"headline\":\"List runs\",\"name\":\"List runs\",\"description\":\"Returns a list of runs belonging to a thread.\",\"url\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-runs\",\"mainEntityOfPage\":{\"@id\":\"https://openai-hd4n6.mintlify.app/api-reference/assistants/list-runs#webpage\"},\"dateModified\":\"2026-01-07T07:53:42.309Z\",\"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-runs.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","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","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","description":"Deletes a 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","description":"Create a 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 runs - 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"]}