Python 88.3%
TypeScript 7.6%
Shell 4.1%
1{2 "_generated_by": "tmp/openai-core/build_fragments.py (agent openai-core)",3 "_generated_at": "2026-09-18",4 "_notation": "dotted paths; [] = array element; (x) = union member discriminated by type/role (e.g. input[](message).content[](input_image).detail); tools[] internals owned by tools fragments",5 "records": [6 {7 "provider": "openai",8 "endpoint": "POST /v1/conversations",9 "parameter": "metadata",10 "location": "body",11 "type": "map<string,string> | null",12 "required": false,13 "default": null,14 "minimum": null,15 "maximum": null,16 "enum": null,17 "description": "Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.",18 "compatible_models": [19 "*"20 ],21 "beta_header": null,22 "status": [23 "DOCUMENTED",24 "LIVE_VERIFIED"25 ],26 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",27 "nullable": true28 },29 {30 "provider": "openai",31 "endpoint": "POST /v1/conversations",32 "parameter": "items",33 "location": "body",34 "type": "array<object<message> | object<message> | object<file_search_call> | object<computer_call> | object<computer_call_output> | object<web_search_call> | object<function_call> | object<function_call_output> | object<tool_search_call> | object<tool_search_output> | object<additional_tools> | object<configuration_update> | object<reasoning> | object<compaction> | object<image_generation_call> | object<code_interpreter_call> | object<local_shell_call> | object<local_shell_call_output> | object<shell_call> | object<shell_call_output> | object<apply_patch_call> | object<apply_patch_call_output> | object<mcp_list_tools> | object<mcp_approval_request> | object<mcp_approval_response> | object<mcp_call> | object<custom_tool_call_output> | object<custom_tool_call> | object<compaction_trigger> | ItemReferenceParam | object<program> | object<program_output>>",35 "required": false,36 "default": null,37 "minimum": null,38 "maximum": null,39 "enum": null,40 "description": "Initial items to include in the conversation context. You may add up to 20 items at a time.",41 "compatible_models": [42 "*"43 ],44 "beta_header": null,45 "status": [46 "DOCUMENTED",47 "LIVE_VERIFIED"48 ],49 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",50 "nullable": true51 },52 {53 "provider": "openai",54 "endpoint": "POST /v1/conversations",55 "parameter": "items[]",56 "location": "body",57 "type": "object<message> | object<file_search_call> | object<computer_call> | object<computer_call_output> | object<web_search_call> | object<function_call> | object<function_call_output> | object<tool_search_call> | object<tool_search_output> | object<additional_tools> | object<configuration_update> | object<reasoning> | object<compaction> | object<image_generation_call> | object<code_interpreter_call> | object<local_shell_call> | object<local_shell_call_output> | object<shell_call> | object<shell_call_output> | object<apply_patch_call> | object<apply_patch_call_output> | object<mcp_list_tools> | object<mcp_approval_request> | object<mcp_approval_response> | object<mcp_call> | object<custom_tool_call_output> | object<custom_tool_call> | object<compaction_trigger> | ItemReferenceParam | object<program> | object<program_output>",58 "required": false,59 "default": null,60 "minimum": null,61 "maximum": null,62 "enum": null,63 "description": "An item representing part of the context for the response to be generated by the model. Can contain text, images, and audio inputs, as well as previous assistant responses and tool call outputs.",64 "compatible_models": [65 "*"66 ],67 "beta_header": null,68 "status": [69 "DOCUMENTED",70 "LIVE_VERIFIED"71 ],72 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",73 "schema_ref": "InputItem"74 },75 {76 "provider": "openai",77 "endpoint": "POST /v1/conversations",78 "parameter": "items[](message)",79 "location": "body",80 "type": "object",81 "required": false,82 "default": null,83 "minimum": null,84 "maximum": null,85 "enum": null,86 "description": "A message input to the model with a role indicating instruction following hierarchy. Instructions given with the `developer` or `system` role take precedence over instructions given with the `user` role. Messages with the `assistant` role are presumed to have been generated by the model in previous interactions.",87 "compatible_models": [88 "*"89 ],90 "beta_header": null,91 "status": [92 "DOCUMENTED",93 "LIVE_VERIFIED"94 ],95 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",96 "variant": "message",97 "schema_ref": "EasyInputMessage"98 },99 {100 "provider": "openai",101 "endpoint": "POST /v1/conversations",102 "parameter": "items[](message).role",103 "location": "body",104 "type": "string",105 "required": true,106 "default": null,107 "minimum": null,108 "maximum": null,109 "enum": [110 "user",111 "assistant",112 "system",113 "developer"114 ],115 "description": "The role of the message input. One of `user`, `assistant`, `system`, or `developer`.",116 "compatible_models": [117 "*"118 ],119 "beta_header": null,120 "status": [121 "DOCUMENTED",122 "LIVE_VERIFIED"123 ],124 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"125 },126 {127 "provider": "openai",128 "endpoint": "POST /v1/conversations",129 "parameter": "items[](message).content",130 "location": "body",131 "type": "string | array<object<input_text> | object<input_image> | object<input_file>> | array<object<output_text> | object<refusal>>",132 "required": true,133 "default": null,134 "minimum": null,135 "maximum": null,136 "enum": null,137 "description": "Text, image, or audio input to the model, used to generate a response. Can also contain previous assistant responses.",138 "compatible_models": [139 "*"140 ],141 "beta_header": null,142 "status": [143 "DOCUMENTED",144 "LIVE_VERIFIED"145 ],146 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"147 },148 {149 "provider": "openai",150 "endpoint": "POST /v1/conversations",151 "parameter": "items[](message).content[]",152 "location": "body",153 "type": "array<object<input_text> | object<input_image> | object<input_file>> | object<input_text> | object<input_file> | object<output_text> | object<refusal>",154 "required": false,155 "default": null,156 "minimum": null,157 "maximum": null,158 "enum": null,159 "description": "A list of one or many input items to the model, containing different content types.",160 "compatible_models": [161 "*"162 ],163 "beta_header": null,164 "status": [165 "DOCUMENTED",166 "LIVE_VERIFIED"167 ],168 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",169 "schema_ref": "InputMessageContentList"170 },171 {172 "provider": "openai",173 "endpoint": "POST /v1/conversations",174 "parameter": "items[](message).phase",175 "location": "body",176 "type": "string | null",177 "required": false,178 "default": null,179 "minimum": null,180 "maximum": null,181 "enum": [182 "commentary",183 "final_answer"184 ],185 "description": "Labels an `assistant` message as intermediate commentary (`commentary`) or the final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending follow-up requests, preserve and resend phase on all assistant messages — dropping it can degrade performance. Not used for user messages.",186 "compatible_models": [187 "*"188 ],189 "beta_header": null,190 "status": [191 "DOCUMENTED"192 ],193 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",194 "nullable": true195 },196 {197 "provider": "openai",198 "endpoint": "POST /v1/conversations",199 "parameter": "items[](message).type",200 "location": "body",201 "type": "string",202 "required": true,203 "default": null,204 "minimum": null,205 "maximum": null,206 "enum": [207 "message"208 ],209 "description": "The type of the message input. Always `message`.",210 "compatible_models": [211 "*"212 ],213 "beta_header": null,214 "status": [215 "DOCUMENTED",216 "LIVE_VERIFIED"217 ],218 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"219 },220 {221 "provider": "openai",222 "endpoint": "POST /v1/conversations",223 "parameter": "items[](message).status",224 "location": "body",225 "type": "string",226 "required": true,227 "default": null,228 "minimum": null,229 "maximum": null,230 "enum": [231 "in_progress",232 "completed",233 "incomplete"234 ],235 "description": "The status of item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.",236 "compatible_models": [237 "*"238 ],239 "beta_header": null,240 "status": [241 "DOCUMENTED"242 ],243 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"244 },245 {246 "provider": "openai",247 "endpoint": "POST /v1/conversations",248 "parameter": "items[](message).id",249 "location": "body",250 "type": "string",251 "required": true,252 "default": null,253 "minimum": null,254 "maximum": null,255 "enum": null,256 "description": "The unique ID of the output message.",257 "compatible_models": [258 "*"259 ],260 "beta_header": null,261 "status": [262 "DOCUMENTED"263 ],264 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"265 },266 {267 "provider": "openai",268 "endpoint": "POST /v1/conversations",269 "parameter": "items[](file_search_call)",270 "location": "body",271 "type": "object",272 "required": false,273 "default": null,274 "minimum": null,275 "maximum": null,276 "enum": null,277 "description": "The results of a file search tool call. See the [file search guide](https://developers.openai.com/api/docs/guides/tools-file-search) for more information.",278 "compatible_models": [279 "*"280 ],281 "beta_header": null,282 "status": [283 "DOCUMENTED"284 ],285 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",286 "variant": "file_search_call",287 "schema_ref": "FileSearchToolCall"288 },289 {290 "provider": "openai",291 "endpoint": "POST /v1/conversations",292 "parameter": "items[](file_search_call).id",293 "location": "body",294 "type": "string",295 "required": true,296 "default": null,297 "minimum": null,298 "maximum": null,299 "enum": null,300 "description": "The unique ID of the file search tool call.",301 "compatible_models": [302 "*"303 ],304 "beta_header": null,305 "status": [306 "DOCUMENTED"307 ],308 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"309 },310 {311 "provider": "openai",312 "endpoint": "POST /v1/conversations",313 "parameter": "items[](file_search_call).type",314 "location": "body",315 "type": "string",316 "required": true,317 "default": null,318 "minimum": null,319 "maximum": null,320 "enum": [321 "file_search_call"322 ],323 "description": "The type of the file search tool call. Always `file_search_call`.",324 "compatible_models": [325 "*"326 ],327 "beta_header": null,328 "status": [329 "DOCUMENTED"330 ],331 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"332 },333 {334 "provider": "openai",335 "endpoint": "POST /v1/conversations",336 "parameter": "items[](file_search_call).status",337 "location": "body",338 "type": "string",339 "required": true,340 "default": null,341 "minimum": null,342 "maximum": null,343 "enum": [344 "in_progress",345 "searching",346 "completed",347 "incomplete",348 "failed"349 ],350 "description": "The status of the file search tool call. One of `in_progress`, `searching`, `incomplete` or `failed`,",351 "compatible_models": [352 "*"353 ],354 "beta_header": null,355 "status": [356 "DOCUMENTED"357 ],358 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"359 },360 {361 "provider": "openai",362 "endpoint": "POST /v1/conversations",363 "parameter": "items[](file_search_call).queries",364 "location": "body",365 "type": "array<string>",366 "required": true,367 "default": null,368 "minimum": null,369 "maximum": null,370 "enum": null,371 "description": "The queries used to search for files.",372 "compatible_models": [373 "*"374 ],375 "beta_header": null,376 "status": [377 "DOCUMENTED"378 ],379 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"380 },381 {382 "provider": "openai",383 "endpoint": "POST /v1/conversations",384 "parameter": "items[](file_search_call).queries[]",385 "location": "body",386 "type": "string",387 "required": false,388 "default": null,389 "minimum": null,390 "maximum": null,391 "enum": null,392 "description": "",393 "compatible_models": [394 "*"395 ],396 "beta_header": null,397 "status": [398 "DOCUMENTED"399 ],400 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"401 },402 {403 "provider": "openai",404 "endpoint": "POST /v1/conversations",405 "parameter": "items[](file_search_call).results",406 "location": "body",407 "type": "array<object>",408 "required": false,409 "default": null,410 "minimum": null,411 "maximum": null,412 "enum": null,413 "description": "The results of the file search tool call.",414 "compatible_models": [415 "*"416 ],417 "beta_header": null,418 "status": [419 "DOCUMENTED"420 ],421 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",422 "nullable": true423 },424 {425 "provider": "openai",426 "endpoint": "POST /v1/conversations",427 "parameter": "items[](file_search_call).results[]",428 "location": "body",429 "type": "object",430 "required": false,431 "default": null,432 "minimum": null,433 "maximum": null,434 "enum": null,435 "description": "",436 "compatible_models": [437 "*"438 ],439 "beta_header": null,440 "status": [441 "DOCUMENTED"442 ],443 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"444 },445 {446 "provider": "openai",447 "endpoint": "POST /v1/conversations",448 "parameter": "items[](computer_call)",449 "location": "body",450 "type": "object",451 "required": false,452 "default": null,453 "minimum": null,454 "maximum": null,455 "enum": null,456 "description": "A tool call to a computer use tool. See the [computer use guide](https://developers.openai.com/api/docs/guides/tools-computer-use) for more information.",457 "compatible_models": [458 "*"459 ],460 "beta_header": null,461 "status": [462 "DOCUMENTED"463 ],464 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",465 "variant": "computer_call",466 "schema_ref": "ComputerToolCall"467 },468 {469 "provider": "openai",470 "endpoint": "POST /v1/conversations",471 "parameter": "items[](computer_call).type",472 "location": "body",473 "type": "string",474 "required": true,475 "default": "computer_call",476 "minimum": null,477 "maximum": null,478 "enum": [479 "computer_call"480 ],481 "description": "The type of the computer call. Always `computer_call`.",482 "compatible_models": [483 "*"484 ],485 "beta_header": null,486 "status": [487 "DOCUMENTED"488 ],489 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"490 },491 {492 "provider": "openai",493 "endpoint": "POST /v1/conversations",494 "parameter": "items[](computer_call).id",495 "location": "body",496 "type": "string",497 "required": true,498 "default": null,499 "minimum": null,500 "maximum": null,501 "enum": null,502 "description": "The unique ID of the computer call.",503 "compatible_models": [504 "*"505 ],506 "beta_header": null,507 "status": [508 "DOCUMENTED"509 ],510 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"511 },512 {513 "provider": "openai",514 "endpoint": "POST /v1/conversations",515 "parameter": "items[](computer_call).call_id",516 "location": "body",517 "type": "string",518 "required": true,519 "default": null,520 "minimum": null,521 "maximum": null,522 "enum": null,523 "description": "An identifier used when responding to the tool call with output.",524 "compatible_models": [525 "*"526 ],527 "beta_header": null,528 "status": [529 "DOCUMENTED"530 ],531 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"532 },533 {534 "provider": "openai",535 "endpoint": "POST /v1/conversations",536 "parameter": "items[](computer_call).action",537 "location": "body",538 "type": "object<click> | object<double_click> | object<drag> | object<keypress> | object<move> | object<screenshot> | object<scroll> | object<type> | object<wait>",539 "required": false,540 "default": null,541 "minimum": null,542 "maximum": null,543 "enum": null,544 "description": "",545 "compatible_models": [546 "*"547 ],548 "beta_header": null,549 "status": [550 "DOCUMENTED"551 ],552 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",553 "schema_ref": "ComputerAction"554 },555 {556 "provider": "openai",557 "endpoint": "POST /v1/conversations",558 "parameter": "items[](computer_call).action(click)",559 "location": "body",560 "type": "object",561 "required": false,562 "default": null,563 "minimum": null,564 "maximum": null,565 "enum": null,566 "description": "A click action.",567 "compatible_models": [568 "*"569 ],570 "beta_header": null,571 "status": [572 "DOCUMENTED"573 ],574 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",575 "variant": "click",576 "schema_ref": "ClickParam"577 },578 {579 "provider": "openai",580 "endpoint": "POST /v1/conversations",581 "parameter": "items[](computer_call).action(double_click)",582 "location": "body",583 "type": "object",584 "required": false,585 "default": null,586 "minimum": null,587 "maximum": null,588 "enum": null,589 "description": "A double click action.",590 "compatible_models": [591 "*"592 ],593 "beta_header": null,594 "status": [595 "DOCUMENTED"596 ],597 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",598 "variant": "double_click",599 "schema_ref": "DoubleClickAction"600 },601 {602 "provider": "openai",603 "endpoint": "POST /v1/conversations",604 "parameter": "items[](computer_call).action(drag)",605 "location": "body",606 "type": "object",607 "required": false,608 "default": null,609 "minimum": null,610 "maximum": null,611 "enum": null,612 "description": "A drag action.",613 "compatible_models": [614 "*"615 ],616 "beta_header": null,617 "status": [618 "DOCUMENTED"619 ],620 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",621 "variant": "drag",622 "schema_ref": "DragParam"623 },624 {625 "provider": "openai",626 "endpoint": "POST /v1/conversations",627 "parameter": "items[](computer_call).action(keypress)",628 "location": "body",629 "type": "object",630 "required": false,631 "default": null,632 "minimum": null,633 "maximum": null,634 "enum": null,635 "description": "A collection of keypresses the model would like to perform.",636 "compatible_models": [637 "*"638 ],639 "beta_header": null,640 "status": [641 "DOCUMENTED"642 ],643 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",644 "variant": "keypress",645 "schema_ref": "KeyPressAction"646 },647 {648 "provider": "openai",649 "endpoint": "POST /v1/conversations",650 "parameter": "items[](computer_call).action(move)",651 "location": "body",652 "type": "object",653 "required": false,654 "default": null,655 "minimum": null,656 "maximum": null,657 "enum": null,658 "description": "A mouse move action.",659 "compatible_models": [660 "*"661 ],662 "beta_header": null,663 "status": [664 "DOCUMENTED"665 ],666 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",667 "variant": "move",668 "schema_ref": "MoveParam"669 },670 {671 "provider": "openai",672 "endpoint": "POST /v1/conversations",673 "parameter": "items[](computer_call).action(screenshot)",674 "location": "body",675 "type": "object",676 "required": false,677 "default": null,678 "minimum": null,679 "maximum": null,680 "enum": null,681 "description": "A screenshot action.",682 "compatible_models": [683 "*"684 ],685 "beta_header": null,686 "status": [687 "DOCUMENTED"688 ],689 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",690 "variant": "screenshot",691 "schema_ref": "ScreenshotParam"692 },693 {694 "provider": "openai",695 "endpoint": "POST /v1/conversations",696 "parameter": "items[](computer_call).action(scroll)",697 "location": "body",698 "type": "object",699 "required": false,700 "default": null,701 "minimum": null,702 "maximum": null,703 "enum": null,704 "description": "A scroll action.",705 "compatible_models": [706 "*"707 ],708 "beta_header": null,709 "status": [710 "DOCUMENTED"711 ],712 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",713 "variant": "scroll",714 "schema_ref": "ScrollParam"715 },716 {717 "provider": "openai",718 "endpoint": "POST /v1/conversations",719 "parameter": "items[](computer_call).action(type)",720 "location": "body",721 "type": "object",722 "required": false,723 "default": null,724 "minimum": null,725 "maximum": null,726 "enum": null,727 "description": "An action to type in text.",728 "compatible_models": [729 "*"730 ],731 "beta_header": null,732 "status": [733 "DOCUMENTED"734 ],735 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",736 "variant": "type",737 "schema_ref": "TypeParam"738 },739 {740 "provider": "openai",741 "endpoint": "POST /v1/conversations",742 "parameter": "items[](computer_call).action(wait)",743 "location": "body",744 "type": "object",745 "required": false,746 "default": null,747 "minimum": null,748 "maximum": null,749 "enum": null,750 "description": "A wait action.",751 "compatible_models": [752 "*"753 ],754 "beta_header": null,755 "status": [756 "DOCUMENTED"757 ],758 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",759 "variant": "wait",760 "schema_ref": "WaitParam"761 },762 {763 "provider": "openai",764 "endpoint": "POST /v1/conversations",765 "parameter": "items[](computer_call).actions",766 "location": "body",767 "type": "array<object<click> | object<double_click> | object<drag> | object<keypress> | object<move> | object<screenshot> | object<scroll> | object<type> | object<wait>>",768 "required": false,769 "default": null,770 "minimum": null,771 "maximum": null,772 "enum": null,773 "description": "Flattened batched actions for `computer_use`. Each action includes an `type` discriminator and action-specific fields.",774 "compatible_models": [775 "*"776 ],777 "beta_header": null,778 "status": [779 "DOCUMENTED"780 ],781 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",782 "schema_ref": "ComputerActionList"783 },784 {785 "provider": "openai",786 "endpoint": "POST /v1/conversations",787 "parameter": "items[](computer_call).actions[]",788 "location": "body",789 "type": "object<click> | object<double_click> | object<drag> | object<keypress> | object<move> | object<screenshot> | object<scroll> | object<type> | object<wait>",790 "required": false,791 "default": null,792 "minimum": null,793 "maximum": null,794 "enum": null,795 "description": "",796 "compatible_models": [797 "*"798 ],799 "beta_header": null,800 "status": [801 "DOCUMENTED"802 ],803 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",804 "schema_ref": "ComputerAction"805 },806 {807 "provider": "openai",808 "endpoint": "POST /v1/conversations",809 "parameter": "items[](computer_call).pending_safety_checks",810 "location": "body",811 "type": "array<object>",812 "required": true,813 "default": null,814 "minimum": null,815 "maximum": null,816 "enum": null,817 "description": "The pending safety checks for the computer call.",818 "compatible_models": [819 "*"820 ],821 "beta_header": null,822 "status": [823 "DOCUMENTED"824 ],825 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"826 },827 {828 "provider": "openai",829 "endpoint": "POST /v1/conversations",830 "parameter": "items[](computer_call).pending_safety_checks[]",831 "location": "body",832 "type": "object",833 "required": false,834 "default": null,835 "minimum": null,836 "maximum": null,837 "enum": null,838 "description": "A pending safety check for the computer call.",839 "compatible_models": [840 "*"841 ],842 "beta_header": null,843 "status": [844 "DOCUMENTED"845 ],846 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",847 "schema_ref": "ComputerCallSafetyCheckParam"848 },849 {850 "provider": "openai",851 "endpoint": "POST /v1/conversations",852 "parameter": "items[](computer_call).status",853 "location": "body",854 "type": "string",855 "required": true,856 "default": null,857 "minimum": null,858 "maximum": null,859 "enum": [860 "in_progress",861 "completed",862 "incomplete"863 ],864 "description": "The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.",865 "compatible_models": [866 "*"867 ],868 "beta_header": null,869 "status": [870 "DOCUMENTED"871 ],872 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"873 },874 {875 "provider": "openai",876 "endpoint": "POST /v1/conversations",877 "parameter": "items[](computer_call_output)",878 "location": "body",879 "type": "object",880 "required": false,881 "default": null,882 "minimum": null,883 "maximum": null,884 "enum": null,885 "description": "The output of a computer tool call.",886 "compatible_models": [887 "*"888 ],889 "beta_header": null,890 "status": [891 "DOCUMENTED"892 ],893 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",894 "variant": "computer_call_output",895 "schema_ref": "ComputerCallOutputItemParam"896 },897 {898 "provider": "openai",899 "endpoint": "POST /v1/conversations",900 "parameter": "items[](computer_call_output).id",901 "location": "body",902 "type": "string | null",903 "required": false,904 "default": null,905 "minimum": null,906 "maximum": null,907 "enum": null,908 "description": "The ID of the computer tool call output.",909 "compatible_models": [910 "*"911 ],912 "beta_header": null,913 "status": [914 "DOCUMENTED"915 ],916 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",917 "nullable": true918 },919 {920 "provider": "openai",921 "endpoint": "POST /v1/conversations",922 "parameter": "items[](computer_call_output).call_id",923 "location": "body",924 "type": "string",925 "required": true,926 "default": null,927 "minimum": null,928 "maximum": null,929 "enum": null,930 "description": "The ID of the computer tool call that produced the output.",931 "compatible_models": [932 "*"933 ],934 "beta_header": null,935 "status": [936 "DOCUMENTED"937 ],938 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"939 },940 {941 "provider": "openai",942 "endpoint": "POST /v1/conversations",943 "parameter": "items[](computer_call_output).type",944 "location": "body",945 "type": "string",946 "required": true,947 "default": "computer_call_output",948 "minimum": null,949 "maximum": null,950 "enum": [951 "computer_call_output"952 ],953 "description": "The type of the computer tool call output. Always `computer_call_output`.",954 "compatible_models": [955 "*"956 ],957 "beta_header": null,958 "status": [959 "DOCUMENTED"960 ],961 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"962 },963 {964 "provider": "openai",965 "endpoint": "POST /v1/conversations",966 "parameter": "items[](computer_call_output).output",967 "location": "body",968 "type": "object",969 "required": true,970 "default": null,971 "minimum": null,972 "maximum": null,973 "enum": null,974 "description": "A computer screenshot image used with the computer use tool.",975 "compatible_models": [976 "*"977 ],978 "beta_header": null,979 "status": [980 "DOCUMENTED"981 ],982 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",983 "schema_ref": "ComputerScreenshotImage"984 },985 {986 "provider": "openai",987 "endpoint": "POST /v1/conversations",988 "parameter": "items[](computer_call_output).output.type",989 "location": "body",990 "type": "string",991 "required": true,992 "default": "computer_screenshot",993 "minimum": null,994 "maximum": null,995 "enum": [996 "computer_screenshot"997 ],998 "description": "Specifies the event type. For a computer screenshot, this property is always set to `computer_screenshot`.",999 "compatible_models": [1000 "*"1001 ],1002 "beta_header": null,1003 "status": [1004 "DOCUMENTED"1005 ],1006 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1007 },1008 {1009 "provider": "openai",1010 "endpoint": "POST /v1/conversations",1011 "parameter": "items[](computer_call_output).output.image_url",1012 "location": "body",1013 "type": "string",1014 "required": false,1015 "default": null,1016 "minimum": null,1017 "maximum": null,1018 "enum": null,1019 "description": "The URL of the screenshot image.",1020 "compatible_models": [1021 "*"1022 ],1023 "beta_header": null,1024 "status": [1025 "DOCUMENTED"1026 ],1027 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1028 },1029 {1030 "provider": "openai",1031 "endpoint": "POST /v1/conversations",1032 "parameter": "items[](computer_call_output).output.file_id",1033 "location": "body",1034 "type": "string",1035 "required": false,1036 "default": null,1037 "minimum": null,1038 "maximum": null,1039 "enum": null,1040 "description": "The identifier of an uploaded file that contains the screenshot.",1041 "compatible_models": [1042 "*"1043 ],1044 "beta_header": null,1045 "status": [1046 "DOCUMENTED"1047 ],1048 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1049 },1050 {1051 "provider": "openai",1052 "endpoint": "POST /v1/conversations",1053 "parameter": "items[](computer_call_output).acknowledged_safety_checks",1054 "location": "body",1055 "type": "array<object>",1056 "required": false,1057 "default": null,1058 "minimum": null,1059 "maximum": null,1060 "enum": null,1061 "description": "The safety checks reported by the API that have been acknowledged by the developer.",1062 "compatible_models": [1063 "*"1064 ],1065 "beta_header": null,1066 "status": [1067 "DOCUMENTED"1068 ],1069 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1070 "nullable": true1071 },1072 {1073 "provider": "openai",1074 "endpoint": "POST /v1/conversations",1075 "parameter": "items[](computer_call_output).acknowledged_safety_checks[]",1076 "location": "body",1077 "type": "object",1078 "required": false,1079 "default": null,1080 "minimum": null,1081 "maximum": null,1082 "enum": null,1083 "description": "A pending safety check for the computer call.",1084 "compatible_models": [1085 "*"1086 ],1087 "beta_header": null,1088 "status": [1089 "DOCUMENTED"1090 ],1091 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1092 "schema_ref": "ComputerCallSafetyCheckParam"1093 },1094 {1095 "provider": "openai",1096 "endpoint": "POST /v1/conversations",1097 "parameter": "items[](computer_call_output).status",1098 "location": "body",1099 "type": "string | null",1100 "required": false,1101 "default": null,1102 "minimum": null,1103 "maximum": null,1104 "enum": [1105 "in_progress",1106 "completed",1107 "incomplete"1108 ],1109 "description": "The status of the message input. One of `in_progress`, `completed`, or `incomplete`. Populated when input items are returned via API.",1110 "compatible_models": [1111 "*"1112 ],1113 "beta_header": null,1114 "status": [1115 "DOCUMENTED"1116 ],1117 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1118 "nullable": true1119 },1120 {1121 "provider": "openai",1122 "endpoint": "POST /v1/conversations",1123 "parameter": "items[](web_search_call)",1124 "location": "body",1125 "type": "object",1126 "required": false,1127 "default": null,1128 "minimum": null,1129 "maximum": null,1130 "enum": null,1131 "description": "The results of a web search tool call. See the [web search guide](https://developers.openai.com/api/docs/guides/tools-web-search) for more information.",1132 "compatible_models": [1133 "*"1134 ],1135 "beta_header": null,1136 "status": [1137 "DOCUMENTED"1138 ],1139 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1140 "variant": "web_search_call",1141 "schema_ref": "WebSearchToolCall"1142 },1143 {1144 "provider": "openai",1145 "endpoint": "POST /v1/conversations",1146 "parameter": "items[](web_search_call).id",1147 "location": "body",1148 "type": "string",1149 "required": true,1150 "default": null,1151 "minimum": null,1152 "maximum": null,1153 "enum": null,1154 "description": "The unique ID of the web search tool call.",1155 "compatible_models": [1156 "*"1157 ],1158 "beta_header": null,1159 "status": [1160 "DOCUMENTED"1161 ],1162 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1163 },1164 {1165 "provider": "openai",1166 "endpoint": "POST /v1/conversations",1167 "parameter": "items[](web_search_call).type",1168 "location": "body",1169 "type": "string",1170 "required": true,1171 "default": null,1172 "minimum": null,1173 "maximum": null,1174 "enum": [1175 "web_search_call"1176 ],1177 "description": "The type of the web search tool call. Always `web_search_call`.",1178 "compatible_models": [1179 "*"1180 ],1181 "beta_header": null,1182 "status": [1183 "DOCUMENTED"1184 ],1185 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1186 },1187 {1188 "provider": "openai",1189 "endpoint": "POST /v1/conversations",1190 "parameter": "items[](web_search_call).status",1191 "location": "body",1192 "type": "string",1193 "required": true,1194 "default": null,1195 "minimum": null,1196 "maximum": null,1197 "enum": [1198 "in_progress",1199 "searching",1200 "completed",1201 "failed",1202 "incomplete"1203 ],1204 "description": "The status of the web search tool call.",1205 "compatible_models": [1206 "*"1207 ],1208 "beta_header": null,1209 "status": [1210 "DOCUMENTED"1211 ],1212 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1213 "schema_ref": "WebSearchCallStatus"1214 },1215 {1216 "provider": "openai",1217 "endpoint": "POST /v1/conversations",1218 "parameter": "items[](web_search_call).action",1219 "location": "body",1220 "type": "object<search> | object<open_page> | object<find_in_page>",1221 "required": true,1222 "default": null,1223 "minimum": null,1224 "maximum": null,1225 "enum": null,1226 "description": "An object describing the specific action taken in this web search call. Includes details on how the model used the web (search, open_page, find_in_page).",1227 "compatible_models": [1228 "*"1229 ],1230 "beta_header": null,1231 "status": [1232 "DOCUMENTED"1233 ],1234 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1235 },1236 {1237 "provider": "openai",1238 "endpoint": "POST /v1/conversations",1239 "parameter": "items[](web_search_call).action(search)",1240 "location": "body",1241 "type": "object",1242 "required": true,1243 "default": null,1244 "minimum": null,1245 "maximum": null,1246 "enum": null,1247 "description": "Action type \"search\" - Performs a web search query.",1248 "compatible_models": [1249 "*"1250 ],1251 "beta_header": null,1252 "status": [1253 "DOCUMENTED"1254 ],1255 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1256 "variant": "search",1257 "schema_ref": "WebSearchActionSearch"1258 },1259 {1260 "provider": "openai",1261 "endpoint": "POST /v1/conversations",1262 "parameter": "items[](web_search_call).action(open_page)",1263 "location": "body",1264 "type": "object",1265 "required": true,1266 "default": null,1267 "minimum": null,1268 "maximum": null,1269 "enum": null,1270 "description": "Action type \"open_page\" - Opens a specific URL from search results.",1271 "compatible_models": [1272 "*"1273 ],1274 "beta_header": null,1275 "status": [1276 "DOCUMENTED"1277 ],1278 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1279 "variant": "open_page",1280 "schema_ref": "WebSearchActionOpenPage"1281 },1282 {1283 "provider": "openai",1284 "endpoint": "POST /v1/conversations",1285 "parameter": "items[](web_search_call).action(find_in_page)",1286 "location": "body",1287 "type": "object",1288 "required": true,1289 "default": null,1290 "minimum": null,1291 "maximum": null,1292 "enum": null,1293 "description": "Action type \"find_in_page\": Searches for a pattern within a loaded page.",1294 "compatible_models": [1295 "*"1296 ],1297 "beta_header": null,1298 "status": [1299 "DOCUMENTED"1300 ],1301 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1302 "variant": "find_in_page",1303 "schema_ref": "WebSearchActionFind"1304 },1305 {1306 "provider": "openai",1307 "endpoint": "POST /v1/conversations",1308 "parameter": "items[](function_call)",1309 "location": "body",1310 "type": "object",1311 "required": false,1312 "default": null,1313 "minimum": null,1314 "maximum": null,1315 "enum": null,1316 "description": "A tool call to run a function. See the [function calling guide](https://developers.openai.com/api/docs/guides/function-calling) for more information.",1317 "compatible_models": [1318 "*"1319 ],1320 "beta_header": null,1321 "status": [1322 "DOCUMENTED"1323 ],1324 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1325 "variant": "function_call",1326 "schema_ref": "FunctionToolCall"1327 },1328 {1329 "provider": "openai",1330 "endpoint": "POST /v1/conversations",1331 "parameter": "items[](function_call).id",1332 "location": "body",1333 "type": "string",1334 "required": false,1335 "default": null,1336 "minimum": null,1337 "maximum": null,1338 "enum": null,1339 "description": "The unique ID of the function tool call.",1340 "compatible_models": [1341 "*"1342 ],1343 "beta_header": null,1344 "status": [1345 "DOCUMENTED"1346 ],1347 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1348 },1349 {1350 "provider": "openai",1351 "endpoint": "POST /v1/conversations",1352 "parameter": "items[](function_call).type",1353 "location": "body",1354 "type": "string",1355 "required": true,1356 "default": null,1357 "minimum": null,1358 "maximum": null,1359 "enum": [1360 "function_call"1361 ],1362 "description": "The type of the function tool call. Always `function_call`.",1363 "compatible_models": [1364 "*"1365 ],1366 "beta_header": null,1367 "status": [1368 "DOCUMENTED"1369 ],1370 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1371 },1372 {1373 "provider": "openai",1374 "endpoint": "POST /v1/conversations",1375 "parameter": "items[](function_call).call_id",1376 "location": "body",1377 "type": "string",1378 "required": true,1379 "default": null,1380 "minimum": null,1381 "maximum": null,1382 "enum": null,1383 "description": "The unique ID of the function tool call generated by the model.",1384 "compatible_models": [1385 "*"1386 ],1387 "beta_header": null,1388 "status": [1389 "DOCUMENTED"1390 ],1391 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1392 },1393 {1394 "provider": "openai",1395 "endpoint": "POST /v1/conversations",1396 "parameter": "items[](function_call).caller",1397 "location": "body",1398 "type": "object<direct> | object<program>",1399 "required": false,1400 "default": null,1401 "minimum": null,1402 "maximum": null,1403 "enum": null,1404 "description": "The execution context that produced this tool call.",1405 "compatible_models": [1406 "*"1407 ],1408 "beta_header": null,1409 "status": [1410 "DOCUMENTED"1411 ],1412 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1413 "nullable": true1414 },1415 {1416 "provider": "openai",1417 "endpoint": "POST /v1/conversations",1418 "parameter": "items[](function_call).caller(direct)",1419 "location": "body",1420 "type": "object",1421 "required": false,1422 "default": null,1423 "minimum": null,1424 "maximum": null,1425 "enum": null,1426 "description": "",1427 "compatible_models": [1428 "*"1429 ],1430 "beta_header": null,1431 "status": [1432 "DOCUMENTED"1433 ],1434 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1435 "variant": "direct",1436 "schema_ref": "DirectToolCallCaller"1437 },1438 {1439 "provider": "openai",1440 "endpoint": "POST /v1/conversations",1441 "parameter": "items[](function_call).caller(program)",1442 "location": "body",1443 "type": "object",1444 "required": false,1445 "default": null,1446 "minimum": null,1447 "maximum": null,1448 "enum": null,1449 "description": "",1450 "compatible_models": [1451 "*"1452 ],1453 "beta_header": null,1454 "status": [1455 "DOCUMENTED"1456 ],1457 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1458 "variant": "program",1459 "schema_ref": "ProgramToolCallCaller"1460 },1461 {1462 "provider": "openai",1463 "endpoint": "POST /v1/conversations",1464 "parameter": "items[](function_call).namespace",1465 "location": "body",1466 "type": "string",1467 "required": false,1468 "default": null,1469 "minimum": null,1470 "maximum": null,1471 "enum": null,1472 "description": "The namespace of the function to run.",1473 "compatible_models": [1474 "*"1475 ],1476 "beta_header": null,1477 "status": [1478 "DOCUMENTED"1479 ],1480 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1481 },1482 {1483 "provider": "openai",1484 "endpoint": "POST /v1/conversations",1485 "parameter": "items[](function_call).name",1486 "location": "body",1487 "type": "string",1488 "required": true,1489 "default": null,1490 "minimum": null,1491 "maximum": null,1492 "enum": null,1493 "description": "The name of the function to run.",1494 "compatible_models": [1495 "*"1496 ],1497 "beta_header": null,1498 "status": [1499 "DOCUMENTED"1500 ],1501 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1502 },1503 {1504 "provider": "openai",1505 "endpoint": "POST /v1/conversations",1506 "parameter": "items[](function_call).arguments",1507 "location": "body",1508 "type": "string",1509 "required": true,1510 "default": null,1511 "minimum": null,1512 "maximum": null,1513 "enum": null,1514 "description": "A JSON string of the arguments to pass to the function.",1515 "compatible_models": [1516 "*"1517 ],1518 "beta_header": null,1519 "status": [1520 "DOCUMENTED"1521 ],1522 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1523 },1524 {1525 "provider": "openai",1526 "endpoint": "POST /v1/conversations",1527 "parameter": "items[](function_call).status",1528 "location": "body",1529 "type": "string",1530 "required": false,1531 "default": null,1532 "minimum": null,1533 "maximum": null,1534 "enum": [1535 "in_progress",1536 "completed",1537 "incomplete"1538 ],1539 "description": "The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.",1540 "compatible_models": [1541 "*"1542 ],1543 "beta_header": null,1544 "status": [1545 "DOCUMENTED"1546 ],1547 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1548 },1549 {1550 "provider": "openai",1551 "endpoint": "POST /v1/conversations",1552 "parameter": "items[](function_call).async",1553 "location": "body",1554 "type": "boolean",1555 "required": false,1556 "default": null,1557 "minimum": null,1558 "maximum": null,1559 "enum": null,1560 "description": "Whether the function tool call runs asynchronously.",1561 "compatible_models": [1562 "*"1563 ],1564 "beta_header": null,1565 "status": [1566 "DOCUMENTED"1567 ],1568 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1569 },1570 {1571 "provider": "openai",1572 "endpoint": "POST /v1/conversations",1573 "parameter": "items[](function_call_output)",1574 "location": "body",1575 "type": "object",1576 "required": false,1577 "default": null,1578 "minimum": null,1579 "maximum": null,1580 "enum": null,1581 "description": "The output of a function tool call.",1582 "compatible_models": [1583 "*"1584 ],1585 "beta_header": null,1586 "status": [1587 "DOCUMENTED"1588 ],1589 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1590 "variant": "function_call_output",1591 "schema_ref": "FunctionCallOutputItemParam"1592 },1593 {1594 "provider": "openai",1595 "endpoint": "POST /v1/conversations",1596 "parameter": "items[](function_call_output).id",1597 "location": "body",1598 "type": "string | null",1599 "required": false,1600 "default": null,1601 "minimum": null,1602 "maximum": null,1603 "enum": null,1604 "description": "The unique ID of the function tool call output. Populated when this item is returned via API.",1605 "compatible_models": [1606 "*"1607 ],1608 "beta_header": null,1609 "status": [1610 "DOCUMENTED"1611 ],1612 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1613 "nullable": true1614 },1615 {1616 "provider": "openai",1617 "endpoint": "POST /v1/conversations",1618 "parameter": "items[](function_call_output).call_id",1619 "location": "body",1620 "type": "string | null",1621 "required": false,1622 "default": null,1623 "minimum": null,1624 "maximum": null,1625 "enum": null,1626 "description": "The unique ID of the function tool call generated by the model.",1627 "compatible_models": [1628 "*"1629 ],1630 "beta_header": null,1631 "status": [1632 "DOCUMENTED"1633 ],1634 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1635 "nullable": true1636 },1637 {1638 "provider": "openai",1639 "endpoint": "POST /v1/conversations",1640 "parameter": "items[](function_call_output).type",1641 "location": "body",1642 "type": "string",1643 "required": true,1644 "default": "function_call_output",1645 "minimum": null,1646 "maximum": null,1647 "enum": [1648 "function_call_output"1649 ],1650 "description": "The type of the function tool call output. Always `function_call_output`.",1651 "compatible_models": [1652 "*"1653 ],1654 "beta_header": null,1655 "status": [1656 "DOCUMENTED"1657 ],1658 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1659 },1660 {1661 "provider": "openai",1662 "endpoint": "POST /v1/conversations",1663 "parameter": "items[](function_call_output).output",1664 "location": "body",1665 "type": "string | array<object<input_text> | object<input_image> | object<input_file>>",1666 "required": true,1667 "default": null,1668 "minimum": null,1669 "maximum": null,1670 "enum": null,1671 "description": "Text, image, or file output of the function tool call.",1672 "compatible_models": [1673 "*"1674 ],1675 "beta_header": null,1676 "status": [1677 "DOCUMENTED"1678 ],1679 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1680 },1681 {1682 "provider": "openai",1683 "endpoint": "POST /v1/conversations",1684 "parameter": "items[](function_call_output).output[]",1685 "location": "body",1686 "type": "array<object<input_text> | object<input_image> | object<input_file>>",1687 "required": false,1688 "default": null,1689 "minimum": null,1690 "maximum": null,1691 "enum": null,1692 "description": "An array of content outputs (text, image, file) for the function tool call.",1693 "compatible_models": [1694 "*"1695 ],1696 "beta_header": null,1697 "status": [1698 "DOCUMENTED"1699 ],1700 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1701 },1702 {1703 "provider": "openai",1704 "endpoint": "POST /v1/conversations",1705 "parameter": "items[](function_call_output).name",1706 "location": "body",1707 "type": "string | null",1708 "required": false,1709 "default": null,1710 "minimum": null,1711 "maximum": null,1712 "enum": null,1713 "description": "The name of the tool that produced the output.",1714 "compatible_models": [1715 "*"1716 ],1717 "beta_header": null,1718 "status": [1719 "DOCUMENTED"1720 ],1721 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1722 "nullable": true1723 },1724 {1725 "provider": "openai",1726 "endpoint": "POST /v1/conversations",1727 "parameter": "items[](function_call_output).namespace",1728 "location": "body",1729 "type": "string | null",1730 "required": false,1731 "default": null,1732 "minimum": null,1733 "maximum": null,1734 "enum": null,1735 "description": "The namespace of the tool that produced the output.",1736 "compatible_models": [1737 "*"1738 ],1739 "beta_header": null,1740 "status": [1741 "DOCUMENTED"1742 ],1743 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1744 "nullable": true1745 },1746 {1747 "provider": "openai",1748 "endpoint": "POST /v1/conversations",1749 "parameter": "items[](function_call_output).caller",1750 "location": "body",1751 "type": "object<direct> | object<program>",1752 "required": false,1753 "default": null,1754 "minimum": null,1755 "maximum": null,1756 "enum": null,1757 "description": "The execution context that produced this tool call.",1758 "compatible_models": [1759 "*"1760 ],1761 "beta_header": null,1762 "status": [1763 "DOCUMENTED"1764 ],1765 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1766 "nullable": true1767 },1768 {1769 "provider": "openai",1770 "endpoint": "POST /v1/conversations",1771 "parameter": "items[](function_call_output).caller(direct)",1772 "location": "body",1773 "type": "object",1774 "required": false,1775 "default": null,1776 "minimum": null,1777 "maximum": null,1778 "enum": null,1779 "description": "",1780 "compatible_models": [1781 "*"1782 ],1783 "beta_header": null,1784 "status": [1785 "DOCUMENTED"1786 ],1787 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1788 "variant": "direct",1789 "schema_ref": "DirectToolCallCallerParam"1790 },1791 {1792 "provider": "openai",1793 "endpoint": "POST /v1/conversations",1794 "parameter": "items[](function_call_output).caller(program)",1795 "location": "body",1796 "type": "object",1797 "required": false,1798 "default": null,1799 "minimum": null,1800 "maximum": null,1801 "enum": null,1802 "description": "",1803 "compatible_models": [1804 "*"1805 ],1806 "beta_header": null,1807 "status": [1808 "DOCUMENTED"1809 ],1810 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1811 "variant": "program",1812 "schema_ref": "ProgramToolCallCallerParam"1813 },1814 {1815 "provider": "openai",1816 "endpoint": "POST /v1/conversations",1817 "parameter": "items[](function_call_output).status",1818 "location": "body",1819 "type": "string | null",1820 "required": false,1821 "default": null,1822 "minimum": null,1823 "maximum": null,1824 "enum": [1825 "in_progress",1826 "completed",1827 "incomplete"1828 ],1829 "description": "The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.",1830 "compatible_models": [1831 "*"1832 ],1833 "beta_header": null,1834 "status": [1835 "DOCUMENTED"1836 ],1837 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1838 "nullable": true1839 },1840 {1841 "provider": "openai",1842 "endpoint": "POST /v1/conversations",1843 "parameter": "items[](tool_search_call)",1844 "location": "body",1845 "type": "object",1846 "required": false,1847 "default": null,1848 "minimum": null,1849 "maximum": null,1850 "enum": null,1851 "description": "",1852 "compatible_models": [1853 "*"1854 ],1855 "beta_header": null,1856 "status": [1857 "DOCUMENTED"1858 ],1859 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1860 "variant": "tool_search_call",1861 "schema_ref": "ToolSearchCallItemParam"1862 },1863 {1864 "provider": "openai",1865 "endpoint": "POST /v1/conversations",1866 "parameter": "items[](tool_search_call).id",1867 "location": "body",1868 "type": "string | null",1869 "required": false,1870 "default": null,1871 "minimum": null,1872 "maximum": null,1873 "enum": null,1874 "description": "The unique ID of this tool search call.",1875 "compatible_models": [1876 "*"1877 ],1878 "beta_header": null,1879 "status": [1880 "DOCUMENTED"1881 ],1882 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1883 "nullable": true1884 },1885 {1886 "provider": "openai",1887 "endpoint": "POST /v1/conversations",1888 "parameter": "items[](tool_search_call).call_id",1889 "location": "body",1890 "type": "string | null",1891 "required": false,1892 "default": null,1893 "minimum": null,1894 "maximum": null,1895 "enum": null,1896 "description": "The unique ID of the tool search call generated by the model.",1897 "compatible_models": [1898 "*"1899 ],1900 "beta_header": null,1901 "status": [1902 "DOCUMENTED"1903 ],1904 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1905 "nullable": true1906 },1907 {1908 "provider": "openai",1909 "endpoint": "POST /v1/conversations",1910 "parameter": "items[](tool_search_call).type",1911 "location": "body",1912 "type": "string",1913 "required": true,1914 "default": "tool_search_call",1915 "minimum": null,1916 "maximum": null,1917 "enum": [1918 "tool_search_call"1919 ],1920 "description": "The item type. Always `tool_search_call`.",1921 "compatible_models": [1922 "*"1923 ],1924 "beta_header": null,1925 "status": [1926 "DOCUMENTED"1927 ],1928 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"1929 },1930 {1931 "provider": "openai",1932 "endpoint": "POST /v1/conversations",1933 "parameter": "items[](tool_search_call).execution",1934 "location": "body",1935 "type": "string",1936 "required": false,1937 "default": null,1938 "minimum": null,1939 "maximum": null,1940 "enum": [1941 "server",1942 "client"1943 ],1944 "description": "Whether tool search was executed by the server or by the client.",1945 "compatible_models": [1946 "*"1947 ],1948 "beta_header": null,1949 "status": [1950 "DOCUMENTED"1951 ],1952 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1953 "schema_ref": "ToolSearchExecutionType"1954 },1955 {1956 "provider": "openai",1957 "endpoint": "POST /v1/conversations",1958 "parameter": "items[](tool_search_call).arguments",1959 "location": "body",1960 "type": "object",1961 "required": true,1962 "default": null,1963 "minimum": null,1964 "maximum": null,1965 "enum": null,1966 "description": "The arguments supplied to the tool search call.",1967 "compatible_models": [1968 "*"1969 ],1970 "beta_header": null,1971 "status": [1972 "DOCUMENTED"1973 ],1974 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",1975 "schema_ref": "EmptyModelParam"1976 },1977 {1978 "provider": "openai",1979 "endpoint": "POST /v1/conversations",1980 "parameter": "items[](tool_search_call).status",1981 "location": "body",1982 "type": "string | null",1983 "required": false,1984 "default": null,1985 "minimum": null,1986 "maximum": null,1987 "enum": [1988 "in_progress",1989 "completed",1990 "incomplete"1991 ],1992 "description": "The status of the tool search call.",1993 "compatible_models": [1994 "*"1995 ],1996 "beta_header": null,1997 "status": [1998 "DOCUMENTED"1999 ],2000 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2001 "nullable": true2002 },2003 {2004 "provider": "openai",2005 "endpoint": "POST /v1/conversations",2006 "parameter": "items[](tool_search_output)",2007 "location": "body",2008 "type": "object",2009 "required": false,2010 "default": null,2011 "minimum": null,2012 "maximum": null,2013 "enum": null,2014 "description": "",2015 "compatible_models": [2016 "*"2017 ],2018 "beta_header": null,2019 "status": [2020 "DOCUMENTED"2021 ],2022 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2023 "variant": "tool_search_output",2024 "schema_ref": "ToolSearchOutputItemParam"2025 },2026 {2027 "provider": "openai",2028 "endpoint": "POST /v1/conversations",2029 "parameter": "items[](tool_search_output).id",2030 "location": "body",2031 "type": "string | null",2032 "required": false,2033 "default": null,2034 "minimum": null,2035 "maximum": null,2036 "enum": null,2037 "description": "The unique ID of this tool search output.",2038 "compatible_models": [2039 "*"2040 ],2041 "beta_header": null,2042 "status": [2043 "DOCUMENTED"2044 ],2045 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2046 "nullable": true2047 },2048 {2049 "provider": "openai",2050 "endpoint": "POST /v1/conversations",2051 "parameter": "items[](tool_search_output).call_id",2052 "location": "body",2053 "type": "string | null",2054 "required": false,2055 "default": null,2056 "minimum": null,2057 "maximum": null,2058 "enum": null,2059 "description": "The unique ID of the tool search call generated by the model.",2060 "compatible_models": [2061 "*"2062 ],2063 "beta_header": null,2064 "status": [2065 "DOCUMENTED"2066 ],2067 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2068 "nullable": true2069 },2070 {2071 "provider": "openai",2072 "endpoint": "POST /v1/conversations",2073 "parameter": "items[](tool_search_output).type",2074 "location": "body",2075 "type": "string",2076 "required": true,2077 "default": "tool_search_output",2078 "minimum": null,2079 "maximum": null,2080 "enum": [2081 "tool_search_output"2082 ],2083 "description": "The item type. Always `tool_search_output`.",2084 "compatible_models": [2085 "*"2086 ],2087 "beta_header": null,2088 "status": [2089 "DOCUMENTED"2090 ],2091 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2092 },2093 {2094 "provider": "openai",2095 "endpoint": "POST /v1/conversations",2096 "parameter": "items[](tool_search_output).execution",2097 "location": "body",2098 "type": "string",2099 "required": false,2100 "default": null,2101 "minimum": null,2102 "maximum": null,2103 "enum": [2104 "server",2105 "client"2106 ],2107 "description": "Whether tool search was executed by the server or by the client.",2108 "compatible_models": [2109 "*"2110 ],2111 "beta_header": null,2112 "status": [2113 "DOCUMENTED"2114 ],2115 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2116 "schema_ref": "ToolSearchExecutionType"2117 },2118 {2119 "provider": "openai",2120 "endpoint": "POST /v1/conversations",2121 "parameter": "items[](tool_search_output).tools",2122 "location": "body",2123 "type": "array<object<function> | object<file_search> | object<computer> | object<computer_use_preview> | WebSearchTool | object<mcp> | object<code_interpreter> | object<programmatic_tool_calling> | object<image_generation> | object<local_shell> | object<shell> | object<custom> | object<namespace> | object<tool_search> | WebSearchPreviewTool | object<apply_patch>>",2124 "required": true,2125 "default": null,2126 "minimum": null,2127 "maximum": null,2128 "enum": null,2129 "description": "The loaded tool definitions returned by the tool search output.",2130 "compatible_models": [2131 "*"2132 ],2133 "beta_header": null,2134 "status": [2135 "DOCUMENTED"2136 ],2137 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2138 },2139 {2140 "provider": "openai",2141 "endpoint": "POST /v1/conversations",2142 "parameter": "items[](tool_search_output).tools[]",2143 "location": "body",2144 "type": "object<function> | object<file_search> | object<computer> | object<computer_use_preview> | WebSearchTool | object<mcp> | object<code_interpreter> | object<programmatic_tool_calling> | object<image_generation> | object<local_shell> | object<shell> | object<custom> | object<namespace> | object<tool_search> | WebSearchPreviewTool | object<apply_patch>",2145 "required": false,2146 "default": null,2147 "minimum": null,2148 "maximum": null,2149 "enum": null,2150 "description": "A tool that can be used to generate a response.",2151 "compatible_models": [2152 "*"2153 ],2154 "beta_header": null,2155 "status": [2156 "DOCUMENTED"2157 ],2158 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2159 "schema_ref": "Tool"2160 },2161 {2162 "provider": "openai",2163 "endpoint": "POST /v1/conversations",2164 "parameter": "items[](tool_search_output).status",2165 "location": "body",2166 "type": "string | null",2167 "required": false,2168 "default": null,2169 "minimum": null,2170 "maximum": null,2171 "enum": [2172 "in_progress",2173 "completed",2174 "incomplete"2175 ],2176 "description": "The status of the tool search output.",2177 "compatible_models": [2178 "*"2179 ],2180 "beta_header": null,2181 "status": [2182 "DOCUMENTED"2183 ],2184 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2185 "nullable": true2186 },2187 {2188 "provider": "openai",2189 "endpoint": "POST /v1/conversations",2190 "parameter": "items[](additional_tools)",2191 "location": "body",2192 "type": "object",2193 "required": false,2194 "default": null,2195 "minimum": null,2196 "maximum": null,2197 "enum": null,2198 "description": "",2199 "compatible_models": [2200 "*"2201 ],2202 "beta_header": null,2203 "status": [2204 "DOCUMENTED"2205 ],2206 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2207 "variant": "additional_tools",2208 "schema_ref": "AdditionalToolsItemParam"2209 },2210 {2211 "provider": "openai",2212 "endpoint": "POST /v1/conversations",2213 "parameter": "items[](additional_tools).id",2214 "location": "body",2215 "type": "string | null",2216 "required": false,2217 "default": null,2218 "minimum": null,2219 "maximum": null,2220 "enum": null,2221 "description": "The unique ID of this additional tools item.",2222 "compatible_models": [2223 "*"2224 ],2225 "beta_header": null,2226 "status": [2227 "DOCUMENTED"2228 ],2229 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2230 "nullable": true2231 },2232 {2233 "provider": "openai",2234 "endpoint": "POST /v1/conversations",2235 "parameter": "items[](additional_tools).type",2236 "location": "body",2237 "type": "string",2238 "required": true,2239 "default": "additional_tools",2240 "minimum": null,2241 "maximum": null,2242 "enum": [2243 "additional_tools"2244 ],2245 "description": "The item type. Always `additional_tools`.",2246 "compatible_models": [2247 "*"2248 ],2249 "beta_header": null,2250 "status": [2251 "DOCUMENTED"2252 ],2253 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2254 },2255 {2256 "provider": "openai",2257 "endpoint": "POST /v1/conversations",2258 "parameter": "items[](additional_tools).role",2259 "location": "body",2260 "type": "string",2261 "required": true,2262 "default": "developer",2263 "minimum": null,2264 "maximum": null,2265 "enum": [2266 "developer"2267 ],2268 "description": "The role that provided the additional tools. Only `developer` is supported.",2269 "compatible_models": [2270 "*"2271 ],2272 "beta_header": null,2273 "status": [2274 "DOCUMENTED"2275 ],2276 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2277 },2278 {2279 "provider": "openai",2280 "endpoint": "POST /v1/conversations",2281 "parameter": "items[](additional_tools).tools",2282 "location": "body",2283 "type": "array<object<function> | object<file_search> | object<computer> | object<computer_use_preview> | WebSearchTool | object<mcp> | object<code_interpreter> | object<programmatic_tool_calling> | object<image_generation> | object<local_shell> | object<shell> | object<custom> | object<namespace> | object<tool_search> | WebSearchPreviewTool | object<apply_patch>>",2284 "required": true,2285 "default": null,2286 "minimum": null,2287 "maximum": null,2288 "enum": null,2289 "description": "A list of additional tools made available at this item.",2290 "compatible_models": [2291 "*"2292 ],2293 "beta_header": null,2294 "status": [2295 "DOCUMENTED"2296 ],2297 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2298 },2299 {2300 "provider": "openai",2301 "endpoint": "POST /v1/conversations",2302 "parameter": "items[](additional_tools).tools[]",2303 "location": "body",2304 "type": "object<function> | object<file_search> | object<computer> | object<computer_use_preview> | WebSearchTool | object<mcp> | object<code_interpreter> | object<programmatic_tool_calling> | object<image_generation> | object<local_shell> | object<shell> | object<custom> | object<namespace> | object<tool_search> | WebSearchPreviewTool | object<apply_patch>",2305 "required": false,2306 "default": null,2307 "minimum": null,2308 "maximum": null,2309 "enum": null,2310 "description": "A tool that can be used to generate a response.",2311 "compatible_models": [2312 "*"2313 ],2314 "beta_header": null,2315 "status": [2316 "DOCUMENTED"2317 ],2318 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2319 "schema_ref": "Tool"2320 },2321 {2322 "provider": "openai",2323 "endpoint": "POST /v1/conversations",2324 "parameter": "items[](configuration_update)",2325 "location": "body",2326 "type": "object",2327 "required": false,2328 "default": null,2329 "minimum": null,2330 "maximum": null,2331 "enum": null,2332 "description": "An update to the conversation's response configuration. The configuration remains in effect for subsequent responses until it is replaced by another configuration update.",2333 "compatible_models": [2334 "*"2335 ],2336 "beta_header": null,2337 "status": [2338 "DOCUMENTED"2339 ],2340 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2341 "variant": "configuration_update",2342 "schema_ref": "ResponseConfigurationUpdateItemParam"2343 },2344 {2345 "provider": "openai",2346 "endpoint": "POST /v1/conversations",2347 "parameter": "items[](configuration_update).id",2348 "location": "body",2349 "type": "string | null",2350 "required": false,2351 "default": null,2352 "minimum": null,2353 "maximum": null,2354 "enum": null,2355 "description": "The unique ID of the configuration update item.",2356 "compatible_models": [2357 "*"2358 ],2359 "beta_header": null,2360 "status": [2361 "DOCUMENTED"2362 ],2363 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2364 "nullable": true2365 },2366 {2367 "provider": "openai",2368 "endpoint": "POST /v1/conversations",2369 "parameter": "items[](configuration_update).type",2370 "location": "body",2371 "type": "string",2372 "required": true,2373 "default": "configuration_update",2374 "minimum": null,2375 "maximum": null,2376 "enum": [2377 "configuration_update"2378 ],2379 "description": "The item type. Always `configuration_update`.",2380 "compatible_models": [2381 "*"2382 ],2383 "beta_header": null,2384 "status": [2385 "DOCUMENTED"2386 ],2387 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2388 },2389 {2390 "provider": "openai",2391 "endpoint": "POST /v1/conversations",2392 "parameter": "items[](configuration_update).reasoning",2393 "location": "body",2394 "type": "object",2395 "required": false,2396 "default": null,2397 "minimum": null,2398 "maximum": null,2399 "enum": null,2400 "description": "Updates to reasoning configuration. Only effort is supported.",2401 "compatible_models": [2402 "*"2403 ],2404 "beta_header": null,2405 "status": [2406 "DOCUMENTED"2407 ],2408 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2409 },2410 {2411 "provider": "openai",2412 "endpoint": "POST /v1/conversations",2413 "parameter": "items[](configuration_update).reasoning.effort",2414 "location": "body",2415 "type": "string | null",2416 "required": false,2417 "default": "medium",2418 "minimum": null,2419 "maximum": null,2420 "enum": [2421 "none",2422 "minimal",2423 "low",2424 "medium",2425 "high",2426 "xhigh",2427 "max"2428 ],2429 "description": "The reasoning effort to use for subsequent responses until another configuration update replaces it.",2430 "compatible_models": [2431 "*"2432 ],2433 "beta_header": null,2434 "status": [2435 "DOCUMENTED"2436 ],2437 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2438 "nullable": true,2439 "schema_ref": "ReasoningEffort"2440 },2441 {2442 "provider": "openai",2443 "endpoint": "POST /v1/conversations",2444 "parameter": "items[](reasoning)",2445 "location": "body",2446 "type": "object",2447 "required": false,2448 "default": null,2449 "minimum": null,2450 "maximum": null,2451 "enum": null,2452 "description": "A description of the chain of thought used by a reasoning model while generating a response. Be sure to include these items in your `input` to the Responses API for subsequent turns of a conversation if you are manually [managing context](https://developers.openai.com/api/docs/guides/conversation-state).",2453 "compatible_models": [2454 "*"2455 ],2456 "beta_header": null,2457 "status": [2458 "DOCUMENTED"2459 ],2460 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2461 "variant": "reasoning",2462 "schema_ref": "ReasoningItem"2463 },2464 {2465 "provider": "openai",2466 "endpoint": "POST /v1/conversations",2467 "parameter": "items[](reasoning).type",2468 "location": "body",2469 "type": "string",2470 "required": true,2471 "default": null,2472 "minimum": null,2473 "maximum": null,2474 "enum": [2475 "reasoning"2476 ],2477 "description": "The type of the object. Always `reasoning`.",2478 "compatible_models": [2479 "*"2480 ],2481 "beta_header": null,2482 "status": [2483 "DOCUMENTED"2484 ],2485 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2486 },2487 {2488 "provider": "openai",2489 "endpoint": "POST /v1/conversations",2490 "parameter": "items[](reasoning).id",2491 "location": "body",2492 "type": "string",2493 "required": true,2494 "default": null,2495 "minimum": null,2496 "maximum": null,2497 "enum": null,2498 "description": "The unique identifier of the reasoning content.",2499 "compatible_models": [2500 "*"2501 ],2502 "beta_header": null,2503 "status": [2504 "DOCUMENTED"2505 ],2506 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2507 },2508 {2509 "provider": "openai",2510 "endpoint": "POST /v1/conversations",2511 "parameter": "items[](reasoning).encrypted_content",2512 "location": "body",2513 "type": "string | null",2514 "required": false,2515 "default": null,2516 "minimum": null,2517 "maximum": null,2518 "enum": null,2519 "description": "The encrypted content of the reasoning item. This is populated by default for reasoning items returned by `POST /v1/responses` and WebSocket `response.create` requests. When streaming, use the completed reasoning item and its `encrypted_content` from the `response.output_item.done` event in subsequent requests. The `encrypted_content` in `response.output_item.added` may be incomplete. This is especially important when `store` is `false` or when using Zero Data Retention.",2520 "compatible_models": [2521 "*"2522 ],2523 "beta_header": null,2524 "status": [2525 "DOCUMENTED"2526 ],2527 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2528 "nullable": true2529 },2530 {2531 "provider": "openai",2532 "endpoint": "POST /v1/conversations",2533 "parameter": "items[](reasoning).summary",2534 "location": "body",2535 "type": "array<object>",2536 "required": true,2537 "default": null,2538 "minimum": null,2539 "maximum": null,2540 "enum": null,2541 "description": "Reasoning summary content.",2542 "compatible_models": [2543 "*"2544 ],2545 "beta_header": null,2546 "status": [2547 "DOCUMENTED"2548 ],2549 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2550 },2551 {2552 "provider": "openai",2553 "endpoint": "POST /v1/conversations",2554 "parameter": "items[](reasoning).summary[]",2555 "location": "body",2556 "type": "object",2557 "required": false,2558 "default": null,2559 "minimum": null,2560 "maximum": null,2561 "enum": null,2562 "description": "A summary text from the model.",2563 "compatible_models": [2564 "*"2565 ],2566 "beta_header": null,2567 "status": [2568 "DOCUMENTED"2569 ],2570 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2571 "schema_ref": "SummaryTextContent"2572 },2573 {2574 "provider": "openai",2575 "endpoint": "POST /v1/conversations",2576 "parameter": "items[](reasoning).content",2577 "location": "body",2578 "type": "array<object>",2579 "required": false,2580 "default": null,2581 "minimum": null,2582 "maximum": null,2583 "enum": null,2584 "description": "Reasoning text content.",2585 "compatible_models": [2586 "*"2587 ],2588 "beta_header": null,2589 "status": [2590 "DOCUMENTED"2591 ],2592 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2593 },2594 {2595 "provider": "openai",2596 "endpoint": "POST /v1/conversations",2597 "parameter": "items[](reasoning).content[]",2598 "location": "body",2599 "type": "object",2600 "required": false,2601 "default": null,2602 "minimum": null,2603 "maximum": null,2604 "enum": null,2605 "description": "Reasoning text from the model.",2606 "compatible_models": [2607 "*"2608 ],2609 "beta_header": null,2610 "status": [2611 "DOCUMENTED"2612 ],2613 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2614 "schema_ref": "ReasoningTextContent"2615 },2616 {2617 "provider": "openai",2618 "endpoint": "POST /v1/conversations",2619 "parameter": "items[](reasoning).status",2620 "location": "body",2621 "type": "string",2622 "required": false,2623 "default": null,2624 "minimum": null,2625 "maximum": null,2626 "enum": [2627 "in_progress",2628 "completed",2629 "incomplete"2630 ],2631 "description": "The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.",2632 "compatible_models": [2633 "*"2634 ],2635 "beta_header": null,2636 "status": [2637 "DOCUMENTED"2638 ],2639 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2640 },2641 {2642 "provider": "openai",2643 "endpoint": "POST /v1/conversations",2644 "parameter": "items[](compaction)",2645 "location": "body",2646 "type": "object",2647 "required": false,2648 "default": null,2649 "minimum": null,2650 "maximum": null,2651 "enum": null,2652 "description": "A compaction item generated by the [`v1/responses/compact` API](https://developers.openai.com/api/reference/resources/responses/methods/compact).",2653 "compatible_models": [2654 "*"2655 ],2656 "beta_header": null,2657 "status": [2658 "DOCUMENTED"2659 ],2660 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2661 "variant": "compaction",2662 "schema_ref": "CompactionSummaryItemParam"2663 },2664 {2665 "provider": "openai",2666 "endpoint": "POST /v1/conversations",2667 "parameter": "items[](compaction).id",2668 "location": "body",2669 "type": "string | null",2670 "required": false,2671 "default": null,2672 "minimum": null,2673 "maximum": null,2674 "enum": null,2675 "description": "The ID of the compaction item.",2676 "compatible_models": [2677 "*"2678 ],2679 "beta_header": null,2680 "status": [2681 "DOCUMENTED"2682 ],2683 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2684 "nullable": true2685 },2686 {2687 "provider": "openai",2688 "endpoint": "POST /v1/conversations",2689 "parameter": "items[](compaction).type",2690 "location": "body",2691 "type": "string",2692 "required": true,2693 "default": "compaction",2694 "minimum": null,2695 "maximum": null,2696 "enum": [2697 "compaction"2698 ],2699 "description": "The type of the item. Always `compaction`.",2700 "compatible_models": [2701 "*"2702 ],2703 "beta_header": null,2704 "status": [2705 "DOCUMENTED"2706 ],2707 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2708 },2709 {2710 "provider": "openai",2711 "endpoint": "POST /v1/conversations",2712 "parameter": "items[](compaction).encrypted_content",2713 "location": "body",2714 "type": "string",2715 "required": true,2716 "default": null,2717 "minimum": null,2718 "maximum": null,2719 "enum": null,2720 "description": "The encrypted content of the compaction summary.",2721 "compatible_models": [2722 "*"2723 ],2724 "beta_header": null,2725 "status": [2726 "DOCUMENTED"2727 ],2728 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2729 },2730 {2731 "provider": "openai",2732 "endpoint": "POST /v1/conversations",2733 "parameter": "items[](image_generation_call)",2734 "location": "body",2735 "type": "object",2736 "required": false,2737 "default": null,2738 "minimum": null,2739 "maximum": null,2740 "enum": null,2741 "description": "An image generation request made by the model.",2742 "compatible_models": [2743 "*"2744 ],2745 "beta_header": null,2746 "status": [2747 "DOCUMENTED"2748 ],2749 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2750 "variant": "image_generation_call",2751 "schema_ref": "ImageGenToolCall"2752 },2753 {2754 "provider": "openai",2755 "endpoint": "POST /v1/conversations",2756 "parameter": "items[](image_generation_call).type",2757 "location": "body",2758 "type": "string",2759 "required": true,2760 "default": null,2761 "minimum": null,2762 "maximum": null,2763 "enum": [2764 "image_generation_call"2765 ],2766 "description": "The type of the image generation call. Always `image_generation_call`.",2767 "compatible_models": [2768 "*"2769 ],2770 "beta_header": null,2771 "status": [2772 "DOCUMENTED"2773 ],2774 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2775 },2776 {2777 "provider": "openai",2778 "endpoint": "POST /v1/conversations",2779 "parameter": "items[](image_generation_call).id",2780 "location": "body",2781 "type": "string",2782 "required": true,2783 "default": null,2784 "minimum": null,2785 "maximum": null,2786 "enum": null,2787 "description": "The unique ID of the image generation call.",2788 "compatible_models": [2789 "*"2790 ],2791 "beta_header": null,2792 "status": [2793 "DOCUMENTED"2794 ],2795 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2796 },2797 {2798 "provider": "openai",2799 "endpoint": "POST /v1/conversations",2800 "parameter": "items[](image_generation_call).status",2801 "location": "body",2802 "type": "string",2803 "required": true,2804 "default": null,2805 "minimum": null,2806 "maximum": null,2807 "enum": [2808 "in_progress",2809 "completed",2810 "generating",2811 "failed"2812 ],2813 "description": "The status of the image generation call.",2814 "compatible_models": [2815 "*"2816 ],2817 "beta_header": null,2818 "status": [2819 "DOCUMENTED"2820 ],2821 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"2822 },2823 {2824 "provider": "openai",2825 "endpoint": "POST /v1/conversations",2826 "parameter": "items[](image_generation_call).result",2827 "location": "body",2828 "type": "string | null",2829 "required": true,2830 "default": null,2831 "minimum": null,2832 "maximum": null,2833 "enum": null,2834 "description": "The generated image encoded in base64.",2835 "compatible_models": [2836 "*"2837 ],2838 "beta_header": null,2839 "status": [2840 "DOCUMENTED"2841 ],2842 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2843 "nullable": true2844 },2845 {2846 "provider": "openai",2847 "endpoint": "POST /v1/conversations",2848 "parameter": "items[](image_generation_call).size",2849 "location": "body",2850 "type": "string",2851 "required": false,2852 "default": null,2853 "minimum": null,2854 "maximum": null,2855 "enum": null,2856 "description": "The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.",2857 "compatible_models": [2858 "*"2859 ],2860 "beta_header": null,2861 "status": [2862 "DOCUMENTED"2863 ],2864 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2865 "nullable": true2866 },2867 {2868 "provider": "openai",2869 "endpoint": "POST /v1/conversations",2870 "parameter": "items[](image_generation_call).quality",2871 "location": "body",2872 "type": "string | null",2873 "required": false,2874 "default": null,2875 "minimum": null,2876 "maximum": null,2877 "enum": [2878 "low",2879 "medium",2880 "high",2881 "xhigh",2882 "max",2883 "auto"2884 ],2885 "description": "The quality of the image generated by the image generation tool call. One of `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.",2886 "compatible_models": [2887 "*"2888 ],2889 "beta_header": null,2890 "status": [2891 "DOCUMENTED"2892 ],2893 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2894 "nullable": true2895 },2896 {2897 "provider": "openai",2898 "endpoint": "POST /v1/conversations",2899 "parameter": "items[](image_generation_call).action",2900 "location": "body",2901 "type": "string | null",2902 "required": false,2903 "default": null,2904 "minimum": null,2905 "maximum": null,2906 "enum": [2907 "generate",2908 "edit",2909 "auto"2910 ],2911 "description": "The action used for image generation.",2912 "compatible_models": [2913 "*"2914 ],2915 "beta_header": null,2916 "status": [2917 "DOCUMENTED"2918 ],2919 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2920 "nullable": true2921 },2922 {2923 "provider": "openai",2924 "endpoint": "POST /v1/conversations",2925 "parameter": "items[](image_generation_call).background",2926 "location": "body",2927 "type": "string | null",2928 "required": false,2929 "default": null,2930 "minimum": null,2931 "maximum": null,2932 "enum": [2933 "transparent",2934 "opaque",2935 "auto"2936 ],2937 "description": "The background setting used for generation.",2938 "compatible_models": [2939 "*"2940 ],2941 "beta_header": null,2942 "status": [2943 "DOCUMENTED"2944 ],2945 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2946 "nullable": true2947 },2948 {2949 "provider": "openai",2950 "endpoint": "POST /v1/conversations",2951 "parameter": "items[](image_generation_call).output_format",2952 "location": "body",2953 "type": "string | null",2954 "required": false,2955 "default": null,2956 "minimum": null,2957 "maximum": null,2958 "enum": [2959 "png",2960 "webp",2961 "jpeg"2962 ],2963 "description": "The output format used for generation.",2964 "compatible_models": [2965 "*"2966 ],2967 "beta_header": null,2968 "status": [2969 "DOCUMENTED"2970 ],2971 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2972 "nullable": true2973 },2974 {2975 "provider": "openai",2976 "endpoint": "POST /v1/conversations",2977 "parameter": "items[](image_generation_call).revised_prompt",2978 "location": "body",2979 "type": "string | null",2980 "required": false,2981 "default": null,2982 "minimum": null,2983 "maximum": null,2984 "enum": null,2985 "description": "The prompt that was used after any model prompt rewriting.",2986 "compatible_models": [2987 "*"2988 ],2989 "beta_header": null,2990 "status": [2991 "DOCUMENTED"2992 ],2993 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",2994 "nullable": true2995 },2996 {2997 "provider": "openai",2998 "endpoint": "POST /v1/conversations",2999 "parameter": "items[](code_interpreter_call)",3000 "location": "body",3001 "type": "object",3002 "required": false,3003 "default": null,3004 "minimum": null,3005 "maximum": null,3006 "enum": null,3007 "description": "A tool call to run code.",3008 "compatible_models": [3009 "*"3010 ],3011 "beta_header": null,3012 "status": [3013 "DOCUMENTED"3014 ],3015 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3016 "variant": "code_interpreter_call",3017 "schema_ref": "CodeInterpreterToolCall"3018 },3019 {3020 "provider": "openai",3021 "endpoint": "POST /v1/conversations",3022 "parameter": "items[](code_interpreter_call).type",3023 "location": "body",3024 "type": "string",3025 "required": true,3026 "default": "code_interpreter_call",3027 "minimum": null,3028 "maximum": null,3029 "enum": [3030 "code_interpreter_call"3031 ],3032 "description": "The type of the code interpreter tool call. Always `code_interpreter_call`.",3033 "compatible_models": [3034 "*"3035 ],3036 "beta_header": null,3037 "status": [3038 "DOCUMENTED"3039 ],3040 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3041 },3042 {3043 "provider": "openai",3044 "endpoint": "POST /v1/conversations",3045 "parameter": "items[](code_interpreter_call).id",3046 "location": "body",3047 "type": "string",3048 "required": true,3049 "default": null,3050 "minimum": null,3051 "maximum": null,3052 "enum": null,3053 "description": "The unique ID of the code interpreter tool call.",3054 "compatible_models": [3055 "*"3056 ],3057 "beta_header": null,3058 "status": [3059 "DOCUMENTED"3060 ],3061 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3062 },3063 {3064 "provider": "openai",3065 "endpoint": "POST /v1/conversations",3066 "parameter": "items[](code_interpreter_call).status",3067 "location": "body",3068 "type": "string",3069 "required": true,3070 "default": null,3071 "minimum": null,3072 "maximum": null,3073 "enum": [3074 "in_progress",3075 "completed",3076 "incomplete",3077 "interpreting",3078 "failed"3079 ],3080 "description": "The status of the code interpreter tool call. Valid values are `in_progress`, `completed`, `incomplete`, `interpreting`, and `failed`.",3081 "compatible_models": [3082 "*"3083 ],3084 "beta_header": null,3085 "status": [3086 "DOCUMENTED"3087 ],3088 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3089 },3090 {3091 "provider": "openai",3092 "endpoint": "POST /v1/conversations",3093 "parameter": "items[](code_interpreter_call).container_id",3094 "location": "body",3095 "type": "string",3096 "required": true,3097 "default": null,3098 "minimum": null,3099 "maximum": null,3100 "enum": null,3101 "description": "The ID of the container used to run the code.",3102 "compatible_models": [3103 "*"3104 ],3105 "beta_header": null,3106 "status": [3107 "DOCUMENTED"3108 ],3109 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3110 },3111 {3112 "provider": "openai",3113 "endpoint": "POST /v1/conversations",3114 "parameter": "items[](code_interpreter_call).code",3115 "location": "body",3116 "type": "string | null",3117 "required": true,3118 "default": null,3119 "minimum": null,3120 "maximum": null,3121 "enum": null,3122 "description": "The code to run, or null if not available.",3123 "compatible_models": [3124 "*"3125 ],3126 "beta_header": null,3127 "status": [3128 "DOCUMENTED"3129 ],3130 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3131 "nullable": true3132 },3133 {3134 "provider": "openai",3135 "endpoint": "POST /v1/conversations",3136 "parameter": "items[](code_interpreter_call).outputs",3137 "location": "body",3138 "type": "array<object<logs> | object<image>>",3139 "required": true,3140 "default": null,3141 "minimum": null,3142 "maximum": null,3143 "enum": null,3144 "description": "The outputs generated by the code interpreter, such as logs or images. Can be null if no outputs are available.",3145 "compatible_models": [3146 "*"3147 ],3148 "beta_header": null,3149 "status": [3150 "DOCUMENTED"3151 ],3152 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3153 "nullable": true3154 },3155 {3156 "provider": "openai",3157 "endpoint": "POST /v1/conversations",3158 "parameter": "items[](code_interpreter_call).outputs[]",3159 "location": "body",3160 "type": "object<logs> | object<image>",3161 "required": false,3162 "default": null,3163 "minimum": null,3164 "maximum": null,3165 "enum": null,3166 "description": "",3167 "compatible_models": [3168 "*"3169 ],3170 "beta_header": null,3171 "status": [3172 "DOCUMENTED"3173 ],3174 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3175 },3176 {3177 "provider": "openai",3178 "endpoint": "POST /v1/conversations",3179 "parameter": "items[](local_shell_call)",3180 "location": "body",3181 "type": "object",3182 "required": false,3183 "default": null,3184 "minimum": null,3185 "maximum": null,3186 "enum": null,3187 "description": "A tool call to run a command on the local shell.",3188 "compatible_models": [3189 "*"3190 ],3191 "beta_header": null,3192 "status": [3193 "DOCUMENTED"3194 ],3195 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3196 "variant": "local_shell_call",3197 "schema_ref": "LocalShellToolCall"3198 },3199 {3200 "provider": "openai",3201 "endpoint": "POST /v1/conversations",3202 "parameter": "items[](local_shell_call).type",3203 "location": "body",3204 "type": "string",3205 "required": true,3206 "default": null,3207 "minimum": null,3208 "maximum": null,3209 "enum": [3210 "local_shell_call"3211 ],3212 "description": "The type of the local shell call. Always `local_shell_call`.",3213 "compatible_models": [3214 "*"3215 ],3216 "beta_header": null,3217 "status": [3218 "DOCUMENTED"3219 ],3220 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3221 },3222 {3223 "provider": "openai",3224 "endpoint": "POST /v1/conversations",3225 "parameter": "items[](local_shell_call).id",3226 "location": "body",3227 "type": "string",3228 "required": true,3229 "default": null,3230 "minimum": null,3231 "maximum": null,3232 "enum": null,3233 "description": "The unique ID of the local shell call.",3234 "compatible_models": [3235 "*"3236 ],3237 "beta_header": null,3238 "status": [3239 "DOCUMENTED"3240 ],3241 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3242 },3243 {3244 "provider": "openai",3245 "endpoint": "POST /v1/conversations",3246 "parameter": "items[](local_shell_call).call_id",3247 "location": "body",3248 "type": "string",3249 "required": true,3250 "default": null,3251 "minimum": null,3252 "maximum": null,3253 "enum": null,3254 "description": "The unique ID of the local shell tool call generated by the model.",3255 "compatible_models": [3256 "*"3257 ],3258 "beta_header": null,3259 "status": [3260 "DOCUMENTED"3261 ],3262 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3263 },3264 {3265 "provider": "openai",3266 "endpoint": "POST /v1/conversations",3267 "parameter": "items[](local_shell_call).action",3268 "location": "body",3269 "type": "object",3270 "required": true,3271 "default": null,3272 "minimum": null,3273 "maximum": null,3274 "enum": null,3275 "description": "Execute a shell command on the server.",3276 "compatible_models": [3277 "*"3278 ],3279 "beta_header": null,3280 "status": [3281 "DOCUMENTED"3282 ],3283 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3284 "schema_ref": "LocalShellExecAction"3285 },3286 {3287 "provider": "openai",3288 "endpoint": "POST /v1/conversations",3289 "parameter": "items[](local_shell_call).action.type",3290 "location": "body",3291 "type": "string",3292 "required": true,3293 "default": "exec",3294 "minimum": null,3295 "maximum": null,3296 "enum": [3297 "exec"3298 ],3299 "description": "The type of the local shell action. Always `exec`.",3300 "compatible_models": [3301 "*"3302 ],3303 "beta_header": null,3304 "status": [3305 "DOCUMENTED"3306 ],3307 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3308 },3309 {3310 "provider": "openai",3311 "endpoint": "POST /v1/conversations",3312 "parameter": "items[](local_shell_call).action.command",3313 "location": "body",3314 "type": "array<string>",3315 "required": true,3316 "default": null,3317 "minimum": null,3318 "maximum": null,3319 "enum": null,3320 "description": "The command to run.",3321 "compatible_models": [3322 "*"3323 ],3324 "beta_header": null,3325 "status": [3326 "DOCUMENTED"3327 ],3328 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3329 },3330 {3331 "provider": "openai",3332 "endpoint": "POST /v1/conversations",3333 "parameter": "items[](local_shell_call).action.timeout_ms",3334 "location": "body",3335 "type": "integer | null",3336 "required": false,3337 "default": null,3338 "minimum": null,3339 "maximum": null,3340 "enum": null,3341 "description": "Optional timeout in milliseconds for the command.",3342 "compatible_models": [3343 "*"3344 ],3345 "beta_header": null,3346 "status": [3347 "DOCUMENTED"3348 ],3349 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3350 "nullable": true3351 },3352 {3353 "provider": "openai",3354 "endpoint": "POST /v1/conversations",3355 "parameter": "items[](local_shell_call).action.working_directory",3356 "location": "body",3357 "type": "string | null",3358 "required": false,3359 "default": null,3360 "minimum": null,3361 "maximum": null,3362 "enum": null,3363 "description": "Optional working directory to run the command in.",3364 "compatible_models": [3365 "*"3366 ],3367 "beta_header": null,3368 "status": [3369 "DOCUMENTED"3370 ],3371 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3372 "nullable": true3373 },3374 {3375 "provider": "openai",3376 "endpoint": "POST /v1/conversations",3377 "parameter": "items[](local_shell_call).action.env",3378 "location": "body",3379 "type": "map<string,string>",3380 "required": true,3381 "default": null,3382 "minimum": null,3383 "maximum": null,3384 "enum": null,3385 "description": "Environment variables to set for the command.",3386 "compatible_models": [3387 "*"3388 ],3389 "beta_header": null,3390 "status": [3391 "DOCUMENTED"3392 ],3393 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3394 },3395 {3396 "provider": "openai",3397 "endpoint": "POST /v1/conversations",3398 "parameter": "items[](local_shell_call).action.user",3399 "location": "body",3400 "type": "string | null",3401 "required": false,3402 "default": null,3403 "minimum": null,3404 "maximum": null,3405 "enum": null,3406 "description": "Optional user to run the command as.",3407 "compatible_models": [3408 "*"3409 ],3410 "beta_header": null,3411 "status": [3412 "DOCUMENTED"3413 ],3414 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3415 "nullable": true3416 },3417 {3418 "provider": "openai",3419 "endpoint": "POST /v1/conversations",3420 "parameter": "items[](local_shell_call).status",3421 "location": "body",3422 "type": "string",3423 "required": true,3424 "default": null,3425 "minimum": null,3426 "maximum": null,3427 "enum": [3428 "in_progress",3429 "completed",3430 "incomplete"3431 ],3432 "description": "The status of the local shell call.",3433 "compatible_models": [3434 "*"3435 ],3436 "beta_header": null,3437 "status": [3438 "DOCUMENTED"3439 ],3440 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3441 },3442 {3443 "provider": "openai",3444 "endpoint": "POST /v1/conversations",3445 "parameter": "items[](local_shell_call_output)",3446 "location": "body",3447 "type": "object",3448 "required": false,3449 "default": null,3450 "minimum": null,3451 "maximum": null,3452 "enum": null,3453 "description": "The output of a local shell tool call.",3454 "compatible_models": [3455 "*"3456 ],3457 "beta_header": null,3458 "status": [3459 "DOCUMENTED"3460 ],3461 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3462 "variant": "local_shell_call_output",3463 "schema_ref": "LocalShellToolCallOutput"3464 },3465 {3466 "provider": "openai",3467 "endpoint": "POST /v1/conversations",3468 "parameter": "items[](local_shell_call_output).type",3469 "location": "body",3470 "type": "string",3471 "required": true,3472 "default": null,3473 "minimum": null,3474 "maximum": null,3475 "enum": [3476 "local_shell_call_output"3477 ],3478 "description": "The type of the local shell tool call output. Always `local_shell_call_output`.",3479 "compatible_models": [3480 "*"3481 ],3482 "beta_header": null,3483 "status": [3484 "DOCUMENTED"3485 ],3486 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3487 },3488 {3489 "provider": "openai",3490 "endpoint": "POST /v1/conversations",3491 "parameter": "items[](local_shell_call_output).id",3492 "location": "body",3493 "type": "string",3494 "required": true,3495 "default": null,3496 "minimum": null,3497 "maximum": null,3498 "enum": null,3499 "description": "The unique ID of the local shell tool call generated by the model.",3500 "compatible_models": [3501 "*"3502 ],3503 "beta_header": null,3504 "status": [3505 "DOCUMENTED"3506 ],3507 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3508 },3509 {3510 "provider": "openai",3511 "endpoint": "POST /v1/conversations",3512 "parameter": "items[](local_shell_call_output).output",3513 "location": "body",3514 "type": "string",3515 "required": true,3516 "default": null,3517 "minimum": null,3518 "maximum": null,3519 "enum": null,3520 "description": "A JSON string of the output of the local shell tool call.",3521 "compatible_models": [3522 "*"3523 ],3524 "beta_header": null,3525 "status": [3526 "DOCUMENTED"3527 ],3528 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3529 },3530 {3531 "provider": "openai",3532 "endpoint": "POST /v1/conversations",3533 "parameter": "items[](local_shell_call_output).status",3534 "location": "body",3535 "type": "string | null",3536 "required": false,3537 "default": null,3538 "minimum": null,3539 "maximum": null,3540 "enum": [3541 "in_progress",3542 "completed",3543 "incomplete"3544 ],3545 "description": "The status of the item. One of `in_progress`, `completed`, or `incomplete`.",3546 "compatible_models": [3547 "*"3548 ],3549 "beta_header": null,3550 "status": [3551 "DOCUMENTED"3552 ],3553 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3554 "nullable": true3555 },3556 {3557 "provider": "openai",3558 "endpoint": "POST /v1/conversations",3559 "parameter": "items[](shell_call)",3560 "location": "body",3561 "type": "object",3562 "required": false,3563 "default": null,3564 "minimum": null,3565 "maximum": null,3566 "enum": null,3567 "description": "A tool representing a request to execute one or more shell commands.",3568 "compatible_models": [3569 "*"3570 ],3571 "beta_header": null,3572 "status": [3573 "DOCUMENTED"3574 ],3575 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3576 "variant": "shell_call",3577 "schema_ref": "FunctionShellCallItemParam"3578 },3579 {3580 "provider": "openai",3581 "endpoint": "POST /v1/conversations",3582 "parameter": "items[](shell_call).id",3583 "location": "body",3584 "type": "string | null",3585 "required": false,3586 "default": null,3587 "minimum": null,3588 "maximum": null,3589 "enum": null,3590 "description": "The unique ID of the shell tool call. Populated when this item is returned via API.",3591 "compatible_models": [3592 "*"3593 ],3594 "beta_header": null,3595 "status": [3596 "DOCUMENTED"3597 ],3598 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3599 "nullable": true3600 },3601 {3602 "provider": "openai",3603 "endpoint": "POST /v1/conversations",3604 "parameter": "items[](shell_call).call_id",3605 "location": "body",3606 "type": "string",3607 "required": true,3608 "default": null,3609 "minimum": null,3610 "maximum": null,3611 "enum": null,3612 "description": "The unique ID of the shell tool call generated by the model.",3613 "compatible_models": [3614 "*"3615 ],3616 "beta_header": null,3617 "status": [3618 "DOCUMENTED"3619 ],3620 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3621 },3622 {3623 "provider": "openai",3624 "endpoint": "POST /v1/conversations",3625 "parameter": "items[](shell_call).caller",3626 "location": "body",3627 "type": "object<direct> | object<program>",3628 "required": false,3629 "default": null,3630 "minimum": null,3631 "maximum": null,3632 "enum": null,3633 "description": "The execution context that produced this tool call.",3634 "compatible_models": [3635 "*"3636 ],3637 "beta_header": null,3638 "status": [3639 "DOCUMENTED"3640 ],3641 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3642 "nullable": true3643 },3644 {3645 "provider": "openai",3646 "endpoint": "POST /v1/conversations",3647 "parameter": "items[](shell_call).caller(direct)",3648 "location": "body",3649 "type": "object",3650 "required": false,3651 "default": null,3652 "minimum": null,3653 "maximum": null,3654 "enum": null,3655 "description": "",3656 "compatible_models": [3657 "*"3658 ],3659 "beta_header": null,3660 "status": [3661 "DOCUMENTED"3662 ],3663 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3664 "variant": "direct",3665 "schema_ref": "DirectToolCallCallerParam"3666 },3667 {3668 "provider": "openai",3669 "endpoint": "POST /v1/conversations",3670 "parameter": "items[](shell_call).caller(program)",3671 "location": "body",3672 "type": "object",3673 "required": false,3674 "default": null,3675 "minimum": null,3676 "maximum": null,3677 "enum": null,3678 "description": "",3679 "compatible_models": [3680 "*"3681 ],3682 "beta_header": null,3683 "status": [3684 "DOCUMENTED"3685 ],3686 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3687 "variant": "program",3688 "schema_ref": "ProgramToolCallCallerParam"3689 },3690 {3691 "provider": "openai",3692 "endpoint": "POST /v1/conversations",3693 "parameter": "items[](shell_call).type",3694 "location": "body",3695 "type": "string",3696 "required": true,3697 "default": "shell_call",3698 "minimum": null,3699 "maximum": null,3700 "enum": [3701 "shell_call"3702 ],3703 "description": "The type of the item. Always `shell_call`.",3704 "compatible_models": [3705 "*"3706 ],3707 "beta_header": null,3708 "status": [3709 "DOCUMENTED"3710 ],3711 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3712 },3713 {3714 "provider": "openai",3715 "endpoint": "POST /v1/conversations",3716 "parameter": "items[](shell_call).action",3717 "location": "body",3718 "type": "object",3719 "required": true,3720 "default": null,3721 "minimum": null,3722 "maximum": null,3723 "enum": null,3724 "description": "The shell commands and limits that describe how to run the tool call.",3725 "compatible_models": [3726 "*"3727 ],3728 "beta_header": null,3729 "status": [3730 "DOCUMENTED"3731 ],3732 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3733 "schema_ref": "FunctionShellActionParam"3734 },3735 {3736 "provider": "openai",3737 "endpoint": "POST /v1/conversations",3738 "parameter": "items[](shell_call).action.commands",3739 "location": "body",3740 "type": "array<string>",3741 "required": true,3742 "default": null,3743 "minimum": null,3744 "maximum": null,3745 "enum": null,3746 "description": "Ordered shell commands for the execution environment to run.",3747 "compatible_models": [3748 "*"3749 ],3750 "beta_header": null,3751 "status": [3752 "DOCUMENTED"3753 ],3754 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3755 },3756 {3757 "provider": "openai",3758 "endpoint": "POST /v1/conversations",3759 "parameter": "items[](shell_call).action.timeout_ms",3760 "location": "body",3761 "type": "integer | null",3762 "required": false,3763 "default": null,3764 "minimum": null,3765 "maximum": null,3766 "enum": null,3767 "description": "Maximum wall-clock time in milliseconds to allow the shell commands to run.",3768 "compatible_models": [3769 "*"3770 ],3771 "beta_header": null,3772 "status": [3773 "DOCUMENTED"3774 ],3775 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3776 "nullable": true3777 },3778 {3779 "provider": "openai",3780 "endpoint": "POST /v1/conversations",3781 "parameter": "items[](shell_call).action.max_output_length",3782 "location": "body",3783 "type": "integer | null",3784 "required": false,3785 "default": null,3786 "minimum": null,3787 "maximum": null,3788 "enum": null,3789 "description": "Maximum number of UTF-8 characters to capture from combined stdout and stderr output.",3790 "compatible_models": [3791 "*"3792 ],3793 "beta_header": null,3794 "status": [3795 "DOCUMENTED"3796 ],3797 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3798 "nullable": true3799 },3800 {3801 "provider": "openai",3802 "endpoint": "POST /v1/conversations",3803 "parameter": "items[](shell_call).status",3804 "location": "body",3805 "type": "string | null",3806 "required": false,3807 "default": null,3808 "minimum": null,3809 "maximum": null,3810 "enum": [3811 "in_progress",3812 "completed",3813 "incomplete"3814 ],3815 "description": "The status of the shell call. One of `in_progress`, `completed`, or `incomplete`.",3816 "compatible_models": [3817 "*"3818 ],3819 "beta_header": null,3820 "status": [3821 "DOCUMENTED"3822 ],3823 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3824 "nullable": true3825 },3826 {3827 "provider": "openai",3828 "endpoint": "POST /v1/conversations",3829 "parameter": "items[](shell_call).environment",3830 "location": "body",3831 "type": "object<local> | object<container_reference>",3832 "required": false,3833 "default": null,3834 "minimum": null,3835 "maximum": null,3836 "enum": null,3837 "description": "The environment to execute the shell commands in.",3838 "compatible_models": [3839 "*"3840 ],3841 "beta_header": null,3842 "status": [3843 "DOCUMENTED"3844 ],3845 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3846 "nullable": true3847 },3848 {3849 "provider": "openai",3850 "endpoint": "POST /v1/conversations",3851 "parameter": "items[](shell_call).environment(local)",3852 "location": "body",3853 "type": "object",3854 "required": false,3855 "default": null,3856 "minimum": null,3857 "maximum": null,3858 "enum": null,3859 "description": "",3860 "compatible_models": [3861 "*"3862 ],3863 "beta_header": null,3864 "status": [3865 "DOCUMENTED"3866 ],3867 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3868 "variant": "local",3869 "schema_ref": "LocalEnvironmentParam"3870 },3871 {3872 "provider": "openai",3873 "endpoint": "POST /v1/conversations",3874 "parameter": "items[](shell_call).environment(container_reference)",3875 "location": "body",3876 "type": "object",3877 "required": false,3878 "default": null,3879 "minimum": null,3880 "maximum": null,3881 "enum": null,3882 "description": "",3883 "compatible_models": [3884 "*"3885 ],3886 "beta_header": null,3887 "status": [3888 "DOCUMENTED"3889 ],3890 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3891 "variant": "container_reference",3892 "schema_ref": "ContainerReferenceParam"3893 },3894 {3895 "provider": "openai",3896 "endpoint": "POST /v1/conversations",3897 "parameter": "items[](shell_call_output)",3898 "location": "body",3899 "type": "object",3900 "required": false,3901 "default": null,3902 "minimum": null,3903 "maximum": null,3904 "enum": null,3905 "description": "The streamed output items emitted by a shell tool call.",3906 "compatible_models": [3907 "*"3908 ],3909 "beta_header": null,3910 "status": [3911 "DOCUMENTED"3912 ],3913 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3914 "variant": "shell_call_output",3915 "schema_ref": "FunctionShellCallOutputItemParam"3916 },3917 {3918 "provider": "openai",3919 "endpoint": "POST /v1/conversations",3920 "parameter": "items[](shell_call_output).id",3921 "location": "body",3922 "type": "string | null",3923 "required": false,3924 "default": null,3925 "minimum": null,3926 "maximum": null,3927 "enum": null,3928 "description": "The unique ID of the shell tool call output. Populated when this item is returned via API.",3929 "compatible_models": [3930 "*"3931 ],3932 "beta_header": null,3933 "status": [3934 "DOCUMENTED"3935 ],3936 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3937 "nullable": true3938 },3939 {3940 "provider": "openai",3941 "endpoint": "POST /v1/conversations",3942 "parameter": "items[](shell_call_output).call_id",3943 "location": "body",3944 "type": "string",3945 "required": true,3946 "default": null,3947 "minimum": null,3948 "maximum": null,3949 "enum": null,3950 "description": "The unique ID of the shell tool call generated by the model.",3951 "compatible_models": [3952 "*"3953 ],3954 "beta_header": null,3955 "status": [3956 "DOCUMENTED"3957 ],3958 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"3959 },3960 {3961 "provider": "openai",3962 "endpoint": "POST /v1/conversations",3963 "parameter": "items[](shell_call_output).caller",3964 "location": "body",3965 "type": "object<direct> | object<program>",3966 "required": false,3967 "default": null,3968 "minimum": null,3969 "maximum": null,3970 "enum": null,3971 "description": "The execution context that produced this tool call.",3972 "compatible_models": [3973 "*"3974 ],3975 "beta_header": null,3976 "status": [3977 "DOCUMENTED"3978 ],3979 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",3980 "nullable": true3981 },3982 {3983 "provider": "openai",3984 "endpoint": "POST /v1/conversations",3985 "parameter": "items[](shell_call_output).caller(direct)",3986 "location": "body",3987 "type": "object",3988 "required": false,3989 "default": null,3990 "minimum": null,3991 "maximum": null,3992 "enum": null,3993 "description": "",3994 "compatible_models": [3995 "*"3996 ],3997 "beta_header": null,3998 "status": [3999 "DOCUMENTED"4000 ],4001 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4002 "variant": "direct",4003 "schema_ref": "DirectToolCallCallerParam"4004 },4005 {4006 "provider": "openai",4007 "endpoint": "POST /v1/conversations",4008 "parameter": "items[](shell_call_output).caller(program)",4009 "location": "body",4010 "type": "object",4011 "required": false,4012 "default": null,4013 "minimum": null,4014 "maximum": null,4015 "enum": null,4016 "description": "",4017 "compatible_models": [4018 "*"4019 ],4020 "beta_header": null,4021 "status": [4022 "DOCUMENTED"4023 ],4024 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4025 "variant": "program",4026 "schema_ref": "ProgramToolCallCallerParam"4027 },4028 {4029 "provider": "openai",4030 "endpoint": "POST /v1/conversations",4031 "parameter": "items[](shell_call_output).type",4032 "location": "body",4033 "type": "string",4034 "required": true,4035 "default": "shell_call_output",4036 "minimum": null,4037 "maximum": null,4038 "enum": [4039 "shell_call_output"4040 ],4041 "description": "The type of the item. Always `shell_call_output`.",4042 "compatible_models": [4043 "*"4044 ],4045 "beta_header": null,4046 "status": [4047 "DOCUMENTED"4048 ],4049 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4050 },4051 {4052 "provider": "openai",4053 "endpoint": "POST /v1/conversations",4054 "parameter": "items[](shell_call_output).output",4055 "location": "body",4056 "type": "array<object>",4057 "required": true,4058 "default": null,4059 "minimum": null,4060 "maximum": null,4061 "enum": null,4062 "description": "Captured chunks of stdout and stderr output, along with their associated outcomes.",4063 "compatible_models": [4064 "*"4065 ],4066 "beta_header": null,4067 "status": [4068 "DOCUMENTED"4069 ],4070 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4071 },4072 {4073 "provider": "openai",4074 "endpoint": "POST /v1/conversations",4075 "parameter": "items[](shell_call_output).output[]",4076 "location": "body",4077 "type": "object",4078 "required": false,4079 "default": null,4080 "minimum": null,4081 "maximum": null,4082 "enum": null,4083 "description": "Captured stdout and stderr for a portion of a shell tool call output.",4084 "compatible_models": [4085 "*"4086 ],4087 "beta_header": null,4088 "status": [4089 "DOCUMENTED"4090 ],4091 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4092 "schema_ref": "FunctionShellCallOutputContentParam"4093 },4094 {4095 "provider": "openai",4096 "endpoint": "POST /v1/conversations",4097 "parameter": "items[](shell_call_output).status",4098 "location": "body",4099 "type": "string | null",4100 "required": false,4101 "default": null,4102 "minimum": null,4103 "maximum": null,4104 "enum": [4105 "in_progress",4106 "completed",4107 "incomplete"4108 ],4109 "description": "The status of the shell call output.",4110 "compatible_models": [4111 "*"4112 ],4113 "beta_header": null,4114 "status": [4115 "DOCUMENTED"4116 ],4117 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4118 "nullable": true4119 },4120 {4121 "provider": "openai",4122 "endpoint": "POST /v1/conversations",4123 "parameter": "items[](shell_call_output).max_output_length",4124 "location": "body",4125 "type": "integer | null",4126 "required": false,4127 "default": null,4128 "minimum": null,4129 "maximum": null,4130 "enum": null,4131 "description": "The maximum number of UTF-8 characters captured for this shell call's combined output.",4132 "compatible_models": [4133 "*"4134 ],4135 "beta_header": null,4136 "status": [4137 "DOCUMENTED"4138 ],4139 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4140 "nullable": true4141 },4142 {4143 "provider": "openai",4144 "endpoint": "POST /v1/conversations",4145 "parameter": "items[](apply_patch_call)",4146 "location": "body",4147 "type": "object",4148 "required": false,4149 "default": null,4150 "minimum": null,4151 "maximum": null,4152 "enum": null,4153 "description": "A tool call representing a request to create, delete, or update files using diff patches.",4154 "compatible_models": [4155 "*"4156 ],4157 "beta_header": null,4158 "status": [4159 "DOCUMENTED"4160 ],4161 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4162 "variant": "apply_patch_call",4163 "schema_ref": "ApplyPatchToolCallItemParam"4164 },4165 {4166 "provider": "openai",4167 "endpoint": "POST /v1/conversations",4168 "parameter": "items[](apply_patch_call).type",4169 "location": "body",4170 "type": "string",4171 "required": true,4172 "default": "apply_patch_call",4173 "minimum": null,4174 "maximum": null,4175 "enum": [4176 "apply_patch_call"4177 ],4178 "description": "The type of the item. Always `apply_patch_call`.",4179 "compatible_models": [4180 "*"4181 ],4182 "beta_header": null,4183 "status": [4184 "DOCUMENTED"4185 ],4186 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4187 },4188 {4189 "provider": "openai",4190 "endpoint": "POST /v1/conversations",4191 "parameter": "items[](apply_patch_call).id",4192 "location": "body",4193 "type": "string | null",4194 "required": false,4195 "default": null,4196 "minimum": null,4197 "maximum": null,4198 "enum": null,4199 "description": "The unique ID of the apply patch tool call. Populated when this item is returned via API.",4200 "compatible_models": [4201 "*"4202 ],4203 "beta_header": null,4204 "status": [4205 "DOCUMENTED"4206 ],4207 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4208 "nullable": true4209 },4210 {4211 "provider": "openai",4212 "endpoint": "POST /v1/conversations",4213 "parameter": "items[](apply_patch_call).call_id",4214 "location": "body",4215 "type": "string",4216 "required": true,4217 "default": null,4218 "minimum": null,4219 "maximum": null,4220 "enum": null,4221 "description": "The unique ID of the apply patch tool call generated by the model.",4222 "compatible_models": [4223 "*"4224 ],4225 "beta_header": null,4226 "status": [4227 "DOCUMENTED"4228 ],4229 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4230 },4231 {4232 "provider": "openai",4233 "endpoint": "POST /v1/conversations",4234 "parameter": "items[](apply_patch_call).caller",4235 "location": "body",4236 "type": "object<direct> | object<program>",4237 "required": false,4238 "default": null,4239 "minimum": null,4240 "maximum": null,4241 "enum": null,4242 "description": "The execution context that produced this tool call.",4243 "compatible_models": [4244 "*"4245 ],4246 "beta_header": null,4247 "status": [4248 "DOCUMENTED"4249 ],4250 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4251 "nullable": true4252 },4253 {4254 "provider": "openai",4255 "endpoint": "POST /v1/conversations",4256 "parameter": "items[](apply_patch_call).caller(direct)",4257 "location": "body",4258 "type": "object",4259 "required": false,4260 "default": null,4261 "minimum": null,4262 "maximum": null,4263 "enum": null,4264 "description": "",4265 "compatible_models": [4266 "*"4267 ],4268 "beta_header": null,4269 "status": [4270 "DOCUMENTED"4271 ],4272 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4273 "variant": "direct",4274 "schema_ref": "DirectToolCallCallerParam"4275 },4276 {4277 "provider": "openai",4278 "endpoint": "POST /v1/conversations",4279 "parameter": "items[](apply_patch_call).caller(program)",4280 "location": "body",4281 "type": "object",4282 "required": false,4283 "default": null,4284 "minimum": null,4285 "maximum": null,4286 "enum": null,4287 "description": "",4288 "compatible_models": [4289 "*"4290 ],4291 "beta_header": null,4292 "status": [4293 "DOCUMENTED"4294 ],4295 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4296 "variant": "program",4297 "schema_ref": "ProgramToolCallCallerParam"4298 },4299 {4300 "provider": "openai",4301 "endpoint": "POST /v1/conversations",4302 "parameter": "items[](apply_patch_call).status",4303 "location": "body",4304 "type": "string",4305 "required": true,4306 "default": null,4307 "minimum": null,4308 "maximum": null,4309 "enum": [4310 "in_progress",4311 "completed"4312 ],4313 "description": "The status of the apply patch tool call. One of `in_progress` or `completed`.",4314 "compatible_models": [4315 "*"4316 ],4317 "beta_header": null,4318 "status": [4319 "DOCUMENTED"4320 ],4321 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4322 "schema_ref": "ApplyPatchCallStatusParam"4323 },4324 {4325 "provider": "openai",4326 "endpoint": "POST /v1/conversations",4327 "parameter": "items[](apply_patch_call).operation",4328 "location": "body",4329 "type": "object<create_file> | object<delete_file> | object<update_file>",4330 "required": true,4331 "default": null,4332 "minimum": null,4333 "maximum": null,4334 "enum": null,4335 "description": "The specific create, delete, or update instruction for the apply_patch tool call.",4336 "compatible_models": [4337 "*"4338 ],4339 "beta_header": null,4340 "status": [4341 "DOCUMENTED"4342 ],4343 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4344 "schema_ref": "ApplyPatchOperationParam"4345 },4346 {4347 "provider": "openai",4348 "endpoint": "POST /v1/conversations",4349 "parameter": "items[](apply_patch_call).operation(create_file)",4350 "location": "body",4351 "type": "object",4352 "required": true,4353 "default": null,4354 "minimum": null,4355 "maximum": null,4356 "enum": null,4357 "description": "Instruction for creating a new file via the apply_patch tool.",4358 "compatible_models": [4359 "*"4360 ],4361 "beta_header": null,4362 "status": [4363 "DOCUMENTED"4364 ],4365 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4366 "variant": "create_file",4367 "schema_ref": "ApplyPatchCreateFileOperationParam"4368 },4369 {4370 "provider": "openai",4371 "endpoint": "POST /v1/conversations",4372 "parameter": "items[](apply_patch_call).operation(delete_file)",4373 "location": "body",4374 "type": "object",4375 "required": true,4376 "default": null,4377 "minimum": null,4378 "maximum": null,4379 "enum": null,4380 "description": "Instruction for deleting an existing file via the apply_patch tool.",4381 "compatible_models": [4382 "*"4383 ],4384 "beta_header": null,4385 "status": [4386 "DOCUMENTED"4387 ],4388 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4389 "variant": "delete_file",4390 "schema_ref": "ApplyPatchDeleteFileOperationParam"4391 },4392 {4393 "provider": "openai",4394 "endpoint": "POST /v1/conversations",4395 "parameter": "items[](apply_patch_call).operation(update_file)",4396 "location": "body",4397 "type": "object",4398 "required": true,4399 "default": null,4400 "minimum": null,4401 "maximum": null,4402 "enum": null,4403 "description": "Instruction for updating an existing file via the apply_patch tool.",4404 "compatible_models": [4405 "*"4406 ],4407 "beta_header": null,4408 "status": [4409 "DOCUMENTED"4410 ],4411 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4412 "variant": "update_file",4413 "schema_ref": "ApplyPatchUpdateFileOperationParam"4414 },4415 {4416 "provider": "openai",4417 "endpoint": "POST /v1/conversations",4418 "parameter": "items[](apply_patch_call_output)",4419 "location": "body",4420 "type": "object",4421 "required": false,4422 "default": null,4423 "minimum": null,4424 "maximum": null,4425 "enum": null,4426 "description": "The streamed output emitted by an apply patch tool call.",4427 "compatible_models": [4428 "*"4429 ],4430 "beta_header": null,4431 "status": [4432 "DOCUMENTED"4433 ],4434 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4435 "variant": "apply_patch_call_output",4436 "schema_ref": "ApplyPatchToolCallOutputItemParam"4437 },4438 {4439 "provider": "openai",4440 "endpoint": "POST /v1/conversations",4441 "parameter": "items[](apply_patch_call_output).type",4442 "location": "body",4443 "type": "string",4444 "required": true,4445 "default": "apply_patch_call_output",4446 "minimum": null,4447 "maximum": null,4448 "enum": [4449 "apply_patch_call_output"4450 ],4451 "description": "The type of the item. Always `apply_patch_call_output`.",4452 "compatible_models": [4453 "*"4454 ],4455 "beta_header": null,4456 "status": [4457 "DOCUMENTED"4458 ],4459 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4460 },4461 {4462 "provider": "openai",4463 "endpoint": "POST /v1/conversations",4464 "parameter": "items[](apply_patch_call_output).id",4465 "location": "body",4466 "type": "string | null",4467 "required": false,4468 "default": null,4469 "minimum": null,4470 "maximum": null,4471 "enum": null,4472 "description": "The unique ID of the apply patch tool call output. Populated when this item is returned via API.",4473 "compatible_models": [4474 "*"4475 ],4476 "beta_header": null,4477 "status": [4478 "DOCUMENTED"4479 ],4480 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4481 "nullable": true4482 },4483 {4484 "provider": "openai",4485 "endpoint": "POST /v1/conversations",4486 "parameter": "items[](apply_patch_call_output).call_id",4487 "location": "body",4488 "type": "string",4489 "required": true,4490 "default": null,4491 "minimum": null,4492 "maximum": null,4493 "enum": null,4494 "description": "The unique ID of the apply patch tool call generated by the model.",4495 "compatible_models": [4496 "*"4497 ],4498 "beta_header": null,4499 "status": [4500 "DOCUMENTED"4501 ],4502 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4503 },4504 {4505 "provider": "openai",4506 "endpoint": "POST /v1/conversations",4507 "parameter": "items[](apply_patch_call_output).caller",4508 "location": "body",4509 "type": "object<direct> | object<program>",4510 "required": false,4511 "default": null,4512 "minimum": null,4513 "maximum": null,4514 "enum": null,4515 "description": "The execution context that produced this tool call.",4516 "compatible_models": [4517 "*"4518 ],4519 "beta_header": null,4520 "status": [4521 "DOCUMENTED"4522 ],4523 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4524 "nullable": true4525 },4526 {4527 "provider": "openai",4528 "endpoint": "POST /v1/conversations",4529 "parameter": "items[](apply_patch_call_output).caller(direct)",4530 "location": "body",4531 "type": "object",4532 "required": false,4533 "default": null,4534 "minimum": null,4535 "maximum": null,4536 "enum": null,4537 "description": "",4538 "compatible_models": [4539 "*"4540 ],4541 "beta_header": null,4542 "status": [4543 "DOCUMENTED"4544 ],4545 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4546 "variant": "direct",4547 "schema_ref": "DirectToolCallCallerParam"4548 },4549 {4550 "provider": "openai",4551 "endpoint": "POST /v1/conversations",4552 "parameter": "items[](apply_patch_call_output).caller(program)",4553 "location": "body",4554 "type": "object",4555 "required": false,4556 "default": null,4557 "minimum": null,4558 "maximum": null,4559 "enum": null,4560 "description": "",4561 "compatible_models": [4562 "*"4563 ],4564 "beta_header": null,4565 "status": [4566 "DOCUMENTED"4567 ],4568 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4569 "variant": "program",4570 "schema_ref": "ProgramToolCallCallerParam"4571 },4572 {4573 "provider": "openai",4574 "endpoint": "POST /v1/conversations",4575 "parameter": "items[](apply_patch_call_output).status",4576 "location": "body",4577 "type": "string",4578 "required": true,4579 "default": null,4580 "minimum": null,4581 "maximum": null,4582 "enum": [4583 "completed",4584 "failed"4585 ],4586 "description": "The status of the apply patch tool call output. One of `completed` or `failed`.",4587 "compatible_models": [4588 "*"4589 ],4590 "beta_header": null,4591 "status": [4592 "DOCUMENTED"4593 ],4594 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4595 "schema_ref": "ApplyPatchCallOutputStatusParam"4596 },4597 {4598 "provider": "openai",4599 "endpoint": "POST /v1/conversations",4600 "parameter": "items[](apply_patch_call_output).output",4601 "location": "body",4602 "type": "string | null",4603 "required": false,4604 "default": null,4605 "minimum": null,4606 "maximum": null,4607 "enum": null,4608 "description": "Optional human-readable log text from the apply patch tool (e.g., patch results or errors).",4609 "compatible_models": [4610 "*"4611 ],4612 "beta_header": null,4613 "status": [4614 "DOCUMENTED"4615 ],4616 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4617 "nullable": true4618 },4619 {4620 "provider": "openai",4621 "endpoint": "POST /v1/conversations",4622 "parameter": "items[](mcp_list_tools)",4623 "location": "body",4624 "type": "object",4625 "required": false,4626 "default": null,4627 "minimum": null,4628 "maximum": null,4629 "enum": null,4630 "description": "A list of tools available on an MCP server.",4631 "compatible_models": [4632 "*"4633 ],4634 "beta_header": null,4635 "status": [4636 "DOCUMENTED"4637 ],4638 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4639 "variant": "mcp_list_tools",4640 "schema_ref": "MCPListTools"4641 },4642 {4643 "provider": "openai",4644 "endpoint": "POST /v1/conversations",4645 "parameter": "items[](mcp_list_tools).type",4646 "location": "body",4647 "type": "string",4648 "required": true,4649 "default": null,4650 "minimum": null,4651 "maximum": null,4652 "enum": [4653 "mcp_list_tools"4654 ],4655 "description": "The type of the item. Always `mcp_list_tools`.",4656 "compatible_models": [4657 "*"4658 ],4659 "beta_header": null,4660 "status": [4661 "DOCUMENTED"4662 ],4663 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4664 },4665 {4666 "provider": "openai",4667 "endpoint": "POST /v1/conversations",4668 "parameter": "items[](mcp_list_tools).id",4669 "location": "body",4670 "type": "string",4671 "required": true,4672 "default": null,4673 "minimum": null,4674 "maximum": null,4675 "enum": null,4676 "description": "The unique ID of the list.",4677 "compatible_models": [4678 "*"4679 ],4680 "beta_header": null,4681 "status": [4682 "DOCUMENTED"4683 ],4684 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4685 },4686 {4687 "provider": "openai",4688 "endpoint": "POST /v1/conversations",4689 "parameter": "items[](mcp_list_tools).server_label",4690 "location": "body",4691 "type": "string",4692 "required": true,4693 "default": null,4694 "minimum": null,4695 "maximum": null,4696 "enum": null,4697 "description": "The label of the MCP server.",4698 "compatible_models": [4699 "*"4700 ],4701 "beta_header": null,4702 "status": [4703 "DOCUMENTED"4704 ],4705 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4706 },4707 {4708 "provider": "openai",4709 "endpoint": "POST /v1/conversations",4710 "parameter": "items[](mcp_list_tools).tools",4711 "location": "body",4712 "type": "array<object>",4713 "required": true,4714 "default": null,4715 "minimum": null,4716 "maximum": null,4717 "enum": null,4718 "description": "The tools available on the server.",4719 "compatible_models": [4720 "*"4721 ],4722 "beta_header": null,4723 "status": [4724 "DOCUMENTED"4725 ],4726 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4727 },4728 {4729 "provider": "openai",4730 "endpoint": "POST /v1/conversations",4731 "parameter": "items[](mcp_list_tools).tools[]",4732 "location": "body",4733 "type": "object",4734 "required": false,4735 "default": null,4736 "minimum": null,4737 "maximum": null,4738 "enum": null,4739 "description": "A tool available on an MCP server.",4740 "compatible_models": [4741 "*"4742 ],4743 "beta_header": null,4744 "status": [4745 "DOCUMENTED"4746 ],4747 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4748 "schema_ref": "MCPListToolsTool"4749 },4750 {4751 "provider": "openai",4752 "endpoint": "POST /v1/conversations",4753 "parameter": "items[](mcp_list_tools).error",4754 "location": "body",4755 "type": "string | null",4756 "required": false,4757 "default": null,4758 "minimum": null,4759 "maximum": null,4760 "enum": null,4761 "description": "Error message if the server could not list tools.",4762 "compatible_models": [4763 "*"4764 ],4765 "beta_header": null,4766 "status": [4767 "DOCUMENTED"4768 ],4769 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4770 "nullable": true4771 },4772 {4773 "provider": "openai",4774 "endpoint": "POST /v1/conversations",4775 "parameter": "items[](mcp_approval_request)",4776 "location": "body",4777 "type": "object",4778 "required": false,4779 "default": null,4780 "minimum": null,4781 "maximum": null,4782 "enum": null,4783 "description": "A request for human approval of a tool invocation.",4784 "compatible_models": [4785 "*"4786 ],4787 "beta_header": null,4788 "status": [4789 "DOCUMENTED"4790 ],4791 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4792 "variant": "mcp_approval_request",4793 "schema_ref": "MCPApprovalRequest"4794 },4795 {4796 "provider": "openai",4797 "endpoint": "POST /v1/conversations",4798 "parameter": "items[](mcp_approval_request).type",4799 "location": "body",4800 "type": "string",4801 "required": true,4802 "default": null,4803 "minimum": null,4804 "maximum": null,4805 "enum": [4806 "mcp_approval_request"4807 ],4808 "description": "The type of the item. Always `mcp_approval_request`.",4809 "compatible_models": [4810 "*"4811 ],4812 "beta_header": null,4813 "status": [4814 "DOCUMENTED"4815 ],4816 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4817 },4818 {4819 "provider": "openai",4820 "endpoint": "POST /v1/conversations",4821 "parameter": "items[](mcp_approval_request).id",4822 "location": "body",4823 "type": "string",4824 "required": true,4825 "default": null,4826 "minimum": null,4827 "maximum": null,4828 "enum": null,4829 "description": "The unique ID of the approval request.",4830 "compatible_models": [4831 "*"4832 ],4833 "beta_header": null,4834 "status": [4835 "DOCUMENTED"4836 ],4837 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4838 },4839 {4840 "provider": "openai",4841 "endpoint": "POST /v1/conversations",4842 "parameter": "items[](mcp_approval_request).server_label",4843 "location": "body",4844 "type": "string",4845 "required": true,4846 "default": null,4847 "minimum": null,4848 "maximum": null,4849 "enum": null,4850 "description": "The label of the MCP server making the request.",4851 "compatible_models": [4852 "*"4853 ],4854 "beta_header": null,4855 "status": [4856 "DOCUMENTED"4857 ],4858 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4859 },4860 {4861 "provider": "openai",4862 "endpoint": "POST /v1/conversations",4863 "parameter": "items[](mcp_approval_request).name",4864 "location": "body",4865 "type": "string",4866 "required": true,4867 "default": null,4868 "minimum": null,4869 "maximum": null,4870 "enum": null,4871 "description": "The name of the tool to run.",4872 "compatible_models": [4873 "*"4874 ],4875 "beta_header": null,4876 "status": [4877 "DOCUMENTED"4878 ],4879 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4880 },4881 {4882 "provider": "openai",4883 "endpoint": "POST /v1/conversations",4884 "parameter": "items[](mcp_approval_request).arguments",4885 "location": "body",4886 "type": "string",4887 "required": true,4888 "default": null,4889 "minimum": null,4890 "maximum": null,4891 "enum": null,4892 "description": "A JSON string of arguments for the tool.",4893 "compatible_models": [4894 "*"4895 ],4896 "beta_header": null,4897 "status": [4898 "DOCUMENTED"4899 ],4900 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4901 },4902 {4903 "provider": "openai",4904 "endpoint": "POST /v1/conversations",4905 "parameter": "items[](mcp_approval_response)",4906 "location": "body",4907 "type": "object",4908 "required": false,4909 "default": null,4910 "minimum": null,4911 "maximum": null,4912 "enum": null,4913 "description": "A response to an MCP approval request.",4914 "compatible_models": [4915 "*"4916 ],4917 "beta_header": null,4918 "status": [4919 "DOCUMENTED"4920 ],4921 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4922 "variant": "mcp_approval_response",4923 "schema_ref": "MCPApprovalResponse"4924 },4925 {4926 "provider": "openai",4927 "endpoint": "POST /v1/conversations",4928 "parameter": "items[](mcp_approval_response).type",4929 "location": "body",4930 "type": "string",4931 "required": true,4932 "default": null,4933 "minimum": null,4934 "maximum": null,4935 "enum": [4936 "mcp_approval_response"4937 ],4938 "description": "The type of the item. Always `mcp_approval_response`.",4939 "compatible_models": [4940 "*"4941 ],4942 "beta_header": null,4943 "status": [4944 "DOCUMENTED"4945 ],4946 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4947 },4948 {4949 "provider": "openai",4950 "endpoint": "POST /v1/conversations",4951 "parameter": "items[](mcp_approval_response).id",4952 "location": "body",4953 "type": "string | null",4954 "required": false,4955 "default": null,4956 "minimum": null,4957 "maximum": null,4958 "enum": null,4959 "description": "The unique ID of the approval response",4960 "compatible_models": [4961 "*"4962 ],4963 "beta_header": null,4964 "status": [4965 "DOCUMENTED"4966 ],4967 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",4968 "nullable": true4969 },4970 {4971 "provider": "openai",4972 "endpoint": "POST /v1/conversations",4973 "parameter": "items[](mcp_approval_response).approval_request_id",4974 "location": "body",4975 "type": "string",4976 "required": true,4977 "default": null,4978 "minimum": null,4979 "maximum": null,4980 "enum": null,4981 "description": "The ID of the approval request being answered.",4982 "compatible_models": [4983 "*"4984 ],4985 "beta_header": null,4986 "status": [4987 "DOCUMENTED"4988 ],4989 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"4990 },4991 {4992 "provider": "openai",4993 "endpoint": "POST /v1/conversations",4994 "parameter": "items[](mcp_approval_response).approve",4995 "location": "body",4996 "type": "boolean",4997 "required": true,4998 "default": null,4999 "minimum": null,5000 "maximum": null,5001 "enum": null,5002 "description": "Whether the request was approved.",5003 "compatible_models": [5004 "*"5005 ],5006 "beta_header": null,5007 "status": [5008 "DOCUMENTED"5009 ],5010 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5011 },5012 {5013 "provider": "openai",5014 "endpoint": "POST /v1/conversations",5015 "parameter": "items[](mcp_approval_response).reason",5016 "location": "body",5017 "type": "string | null",5018 "required": false,5019 "default": null,5020 "minimum": null,5021 "maximum": null,5022 "enum": null,5023 "description": "Optional reason for the decision.",5024 "compatible_models": [5025 "*"5026 ],5027 "beta_header": null,5028 "status": [5029 "DOCUMENTED"5030 ],5031 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5032 "nullable": true5033 },5034 {5035 "provider": "openai",5036 "endpoint": "POST /v1/conversations",5037 "parameter": "items[](mcp_call)",5038 "location": "body",5039 "type": "object",5040 "required": false,5041 "default": null,5042 "minimum": null,5043 "maximum": null,5044 "enum": null,5045 "description": "An invocation of a tool on an MCP server.",5046 "compatible_models": [5047 "*"5048 ],5049 "beta_header": null,5050 "status": [5051 "DOCUMENTED"5052 ],5053 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5054 "variant": "mcp_call",5055 "schema_ref": "MCPToolCall"5056 },5057 {5058 "provider": "openai",5059 "endpoint": "POST /v1/conversations",5060 "parameter": "items[](mcp_call).type",5061 "location": "body",5062 "type": "string",5063 "required": true,5064 "default": null,5065 "minimum": null,5066 "maximum": null,5067 "enum": [5068 "mcp_call"5069 ],5070 "description": "The type of the item. Always `mcp_call`.",5071 "compatible_models": [5072 "*"5073 ],5074 "beta_header": null,5075 "status": [5076 "DOCUMENTED"5077 ],5078 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5079 },5080 {5081 "provider": "openai",5082 "endpoint": "POST /v1/conversations",5083 "parameter": "items[](mcp_call).id",5084 "location": "body",5085 "type": "string",5086 "required": true,5087 "default": null,5088 "minimum": null,5089 "maximum": null,5090 "enum": null,5091 "description": "The unique ID of the tool call.",5092 "compatible_models": [5093 "*"5094 ],5095 "beta_header": null,5096 "status": [5097 "DOCUMENTED"5098 ],5099 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5100 },5101 {5102 "provider": "openai",5103 "endpoint": "POST /v1/conversations",5104 "parameter": "items[](mcp_call).server_label",5105 "location": "body",5106 "type": "string",5107 "required": true,5108 "default": null,5109 "minimum": null,5110 "maximum": null,5111 "enum": null,5112 "description": "The label of the MCP server running the tool.",5113 "compatible_models": [5114 "*"5115 ],5116 "beta_header": null,5117 "status": [5118 "DOCUMENTED"5119 ],5120 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5121 },5122 {5123 "provider": "openai",5124 "endpoint": "POST /v1/conversations",5125 "parameter": "items[](mcp_call).name",5126 "location": "body",5127 "type": "string",5128 "required": true,5129 "default": null,5130 "minimum": null,5131 "maximum": null,5132 "enum": null,5133 "description": "The name of the tool that was run.",5134 "compatible_models": [5135 "*"5136 ],5137 "beta_header": null,5138 "status": [5139 "DOCUMENTED"5140 ],5141 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5142 },5143 {5144 "provider": "openai",5145 "endpoint": "POST /v1/conversations",5146 "parameter": "items[](mcp_call).arguments",5147 "location": "body",5148 "type": "string",5149 "required": true,5150 "default": null,5151 "minimum": null,5152 "maximum": null,5153 "enum": null,5154 "description": "A JSON string of the arguments passed to the tool.",5155 "compatible_models": [5156 "*"5157 ],5158 "beta_header": null,5159 "status": [5160 "DOCUMENTED"5161 ],5162 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5163 },5164 {5165 "provider": "openai",5166 "endpoint": "POST /v1/conversations",5167 "parameter": "items[](mcp_call).output",5168 "location": "body",5169 "type": "string | null",5170 "required": false,5171 "default": null,5172 "minimum": null,5173 "maximum": null,5174 "enum": null,5175 "description": "The output from the tool call.",5176 "compatible_models": [5177 "*"5178 ],5179 "beta_header": null,5180 "status": [5181 "DOCUMENTED"5182 ],5183 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5184 "nullable": true5185 },5186 {5187 "provider": "openai",5188 "endpoint": "POST /v1/conversations",5189 "parameter": "items[](mcp_call).error",5190 "location": "body",5191 "type": "object<mcp_protocol_error> | object<mcp_tool_execution_error> | object<http_error>",5192 "required": false,5193 "default": null,5194 "minimum": null,5195 "maximum": null,5196 "enum": null,5197 "description": "The error from the tool call, if any.",5198 "compatible_models": [5199 "*"5200 ],5201 "beta_header": null,5202 "status": [5203 "DOCUMENTED"5204 ],5205 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5206 "nullable": true5207 },5208 {5209 "provider": "openai",5210 "endpoint": "POST /v1/conversations",5211 "parameter": "items[](mcp_call).error(mcp_protocol_error)",5212 "location": "body",5213 "type": "object",5214 "required": false,5215 "default": null,5216 "minimum": null,5217 "maximum": null,5218 "enum": null,5219 "description": "",5220 "compatible_models": [5221 "*"5222 ],5223 "beta_header": null,5224 "status": [5225 "DOCUMENTED"5226 ],5227 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5228 "variant": "mcp_protocol_error",5229 "schema_ref": "MCPProtocolError"5230 },5231 {5232 "provider": "openai",5233 "endpoint": "POST /v1/conversations",5234 "parameter": "items[](mcp_call).error(mcp_tool_execution_error)",5235 "location": "body",5236 "type": "object",5237 "required": false,5238 "default": null,5239 "minimum": null,5240 "maximum": null,5241 "enum": null,5242 "description": "",5243 "compatible_models": [5244 "*"5245 ],5246 "beta_header": null,5247 "status": [5248 "DOCUMENTED"5249 ],5250 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5251 "variant": "mcp_tool_execution_error",5252 "schema_ref": "MCPToolExecutionError"5253 },5254 {5255 "provider": "openai",5256 "endpoint": "POST /v1/conversations",5257 "parameter": "items[](mcp_call).error(http_error)",5258 "location": "body",5259 "type": "object",5260 "required": false,5261 "default": null,5262 "minimum": null,5263 "maximum": null,5264 "enum": null,5265 "description": "",5266 "compatible_models": [5267 "*"5268 ],5269 "beta_header": null,5270 "status": [5271 "DOCUMENTED"5272 ],5273 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5274 "variant": "http_error",5275 "schema_ref": "HTTPError"5276 },5277 {5278 "provider": "openai",5279 "endpoint": "POST /v1/conversations",5280 "parameter": "items[](mcp_call).status",5281 "location": "body",5282 "type": "string",5283 "required": false,5284 "default": null,5285 "minimum": null,5286 "maximum": null,5287 "enum": [5288 "in_progress",5289 "completed",5290 "incomplete",5291 "calling",5292 "failed"5293 ],5294 "description": "The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`, or `failed`.",5295 "compatible_models": [5296 "*"5297 ],5298 "beta_header": null,5299 "status": [5300 "DOCUMENTED"5301 ],5302 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5303 "schema_ref": "MCPToolCallStatus"5304 },5305 {5306 "provider": "openai",5307 "endpoint": "POST /v1/conversations",5308 "parameter": "items[](mcp_call).approval_request_id",5309 "location": "body",5310 "type": "string | null",5311 "required": false,5312 "default": null,5313 "minimum": null,5314 "maximum": null,5315 "enum": null,5316 "description": "Unique identifier for the MCP tool call approval request. Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.",5317 "compatible_models": [5318 "*"5319 ],5320 "beta_header": null,5321 "status": [5322 "DOCUMENTED"5323 ],5324 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5325 "nullable": true5326 },5327 {5328 "provider": "openai",5329 "endpoint": "POST /v1/conversations",5330 "parameter": "items[](custom_tool_call_output)",5331 "location": "body",5332 "type": "object",5333 "required": false,5334 "default": null,5335 "minimum": null,5336 "maximum": null,5337 "enum": null,5338 "description": "The output of a custom tool call from your code, being sent back to the model.",5339 "compatible_models": [5340 "*"5341 ],5342 "beta_header": null,5343 "status": [5344 "DOCUMENTED"5345 ],5346 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5347 "variant": "custom_tool_call_output",5348 "schema_ref": "CustomToolCallOutput"5349 },5350 {5351 "provider": "openai",5352 "endpoint": "POST /v1/conversations",5353 "parameter": "items[](custom_tool_call_output).type",5354 "location": "body",5355 "type": "string",5356 "required": true,5357 "default": null,5358 "minimum": null,5359 "maximum": null,5360 "enum": [5361 "custom_tool_call_output"5362 ],5363 "description": "The type of the custom tool call output. Always `custom_tool_call_output`.",5364 "compatible_models": [5365 "*"5366 ],5367 "beta_header": null,5368 "status": [5369 "DOCUMENTED"5370 ],5371 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5372 },5373 {5374 "provider": "openai",5375 "endpoint": "POST /v1/conversations",5376 "parameter": "items[](custom_tool_call_output).id",5377 "location": "body",5378 "type": "string",5379 "required": false,5380 "default": null,5381 "minimum": null,5382 "maximum": null,5383 "enum": null,5384 "description": "The unique ID of the custom tool call output in the OpenAI platform.",5385 "compatible_models": [5386 "*"5387 ],5388 "beta_header": null,5389 "status": [5390 "DOCUMENTED"5391 ],5392 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5393 },5394 {5395 "provider": "openai",5396 "endpoint": "POST /v1/conversations",5397 "parameter": "items[](custom_tool_call_output).call_id",5398 "location": "body",5399 "type": "string",5400 "required": true,5401 "default": null,5402 "minimum": null,5403 "maximum": null,5404 "enum": null,5405 "description": "The call ID, used to map this custom tool call output to a custom tool call.",5406 "compatible_models": [5407 "*"5408 ],5409 "beta_header": null,5410 "status": [5411 "DOCUMENTED"5412 ],5413 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5414 },5415 {5416 "provider": "openai",5417 "endpoint": "POST /v1/conversations",5418 "parameter": "items[](custom_tool_call_output).caller",5419 "location": "body",5420 "type": "object<direct> | object<program>",5421 "required": false,5422 "default": null,5423 "minimum": null,5424 "maximum": null,5425 "enum": null,5426 "description": "The execution context that produced this tool call.",5427 "compatible_models": [5428 "*"5429 ],5430 "beta_header": null,5431 "status": [5432 "DOCUMENTED"5433 ],5434 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5435 "nullable": true5436 },5437 {5438 "provider": "openai",5439 "endpoint": "POST /v1/conversations",5440 "parameter": "items[](custom_tool_call_output).caller(direct)",5441 "location": "body",5442 "type": "object",5443 "required": false,5444 "default": null,5445 "minimum": null,5446 "maximum": null,5447 "enum": null,5448 "description": "",5449 "compatible_models": [5450 "*"5451 ],5452 "beta_header": null,5453 "status": [5454 "DOCUMENTED"5455 ],5456 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5457 "variant": "direct",5458 "schema_ref": "DirectToolCallCallerParam"5459 },5460 {5461 "provider": "openai",5462 "endpoint": "POST /v1/conversations",5463 "parameter": "items[](custom_tool_call_output).caller(program)",5464 "location": "body",5465 "type": "object",5466 "required": false,5467 "default": null,5468 "minimum": null,5469 "maximum": null,5470 "enum": null,5471 "description": "",5472 "compatible_models": [5473 "*"5474 ],5475 "beta_header": null,5476 "status": [5477 "DOCUMENTED"5478 ],5479 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5480 "variant": "program",5481 "schema_ref": "ProgramToolCallCallerParam"5482 },5483 {5484 "provider": "openai",5485 "endpoint": "POST /v1/conversations",5486 "parameter": "items[](custom_tool_call_output).output",5487 "location": "body",5488 "type": "string | array<object<input_text> | object<input_image> | object<input_file>>",5489 "required": true,5490 "default": null,5491 "minimum": null,5492 "maximum": null,5493 "enum": null,5494 "description": "The output from the custom tool call generated by your code. Can be a string or an list of output content.",5495 "compatible_models": [5496 "*"5497 ],5498 "beta_header": null,5499 "status": [5500 "DOCUMENTED"5501 ],5502 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5503 },5504 {5505 "provider": "openai",5506 "endpoint": "POST /v1/conversations",5507 "parameter": "items[](custom_tool_call_output).output[]",5508 "location": "body",5509 "type": "array<object<input_text> | object<input_image> | object<input_file>>",5510 "required": false,5511 "default": null,5512 "minimum": null,5513 "maximum": null,5514 "enum": null,5515 "description": "Text, image, or file output of the custom tool call.",5516 "compatible_models": [5517 "*"5518 ],5519 "beta_header": null,5520 "status": [5521 "DOCUMENTED"5522 ],5523 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5524 },5525 {5526 "provider": "openai",5527 "endpoint": "POST /v1/conversations",5528 "parameter": "items[](custom_tool_call)",5529 "location": "body",5530 "type": "object",5531 "required": false,5532 "default": null,5533 "minimum": null,5534 "maximum": null,5535 "enum": null,5536 "description": "A call to a custom tool created by the model.",5537 "compatible_models": [5538 "*"5539 ],5540 "beta_header": null,5541 "status": [5542 "DOCUMENTED"5543 ],5544 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5545 "variant": "custom_tool_call",5546 "schema_ref": "CustomToolCall"5547 },5548 {5549 "provider": "openai",5550 "endpoint": "POST /v1/conversations",5551 "parameter": "items[](custom_tool_call).type",5552 "location": "body",5553 "type": "string",5554 "required": true,5555 "default": null,5556 "minimum": null,5557 "maximum": null,5558 "enum": [5559 "custom_tool_call"5560 ],5561 "description": "The type of the custom tool call. Always `custom_tool_call`.",5562 "compatible_models": [5563 "*"5564 ],5565 "beta_header": null,5566 "status": [5567 "DOCUMENTED"5568 ],5569 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5570 },5571 {5572 "provider": "openai",5573 "endpoint": "POST /v1/conversations",5574 "parameter": "items[](custom_tool_call).id",5575 "location": "body",5576 "type": "string",5577 "required": false,5578 "default": null,5579 "minimum": null,5580 "maximum": null,5581 "enum": null,5582 "description": "The unique ID of the custom tool call in the OpenAI platform.",5583 "compatible_models": [5584 "*"5585 ],5586 "beta_header": null,5587 "status": [5588 "DOCUMENTED"5589 ],5590 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5591 },5592 {5593 "provider": "openai",5594 "endpoint": "POST /v1/conversations",5595 "parameter": "items[](custom_tool_call).call_id",5596 "location": "body",5597 "type": "string",5598 "required": true,5599 "default": null,5600 "minimum": null,5601 "maximum": null,5602 "enum": null,5603 "description": "An identifier used to map this custom tool call to a tool call output.",5604 "compatible_models": [5605 "*"5606 ],5607 "beta_header": null,5608 "status": [5609 "DOCUMENTED"5610 ],5611 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5612 },5613 {5614 "provider": "openai",5615 "endpoint": "POST /v1/conversations",5616 "parameter": "items[](custom_tool_call).caller",5617 "location": "body",5618 "type": "object<direct> | object<program>",5619 "required": false,5620 "default": null,5621 "minimum": null,5622 "maximum": null,5623 "enum": null,5624 "description": "The execution context that produced this tool call.",5625 "compatible_models": [5626 "*"5627 ],5628 "beta_header": null,5629 "status": [5630 "DOCUMENTED"5631 ],5632 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5633 "nullable": true5634 },5635 {5636 "provider": "openai",5637 "endpoint": "POST /v1/conversations",5638 "parameter": "items[](custom_tool_call).caller(direct)",5639 "location": "body",5640 "type": "object",5641 "required": false,5642 "default": null,5643 "minimum": null,5644 "maximum": null,5645 "enum": null,5646 "description": "",5647 "compatible_models": [5648 "*"5649 ],5650 "beta_header": null,5651 "status": [5652 "DOCUMENTED"5653 ],5654 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5655 "variant": "direct",5656 "schema_ref": "DirectToolCallCaller"5657 },5658 {5659 "provider": "openai",5660 "endpoint": "POST /v1/conversations",5661 "parameter": "items[](custom_tool_call).caller(program)",5662 "location": "body",5663 "type": "object",5664 "required": false,5665 "default": null,5666 "minimum": null,5667 "maximum": null,5668 "enum": null,5669 "description": "",5670 "compatible_models": [5671 "*"5672 ],5673 "beta_header": null,5674 "status": [5675 "DOCUMENTED"5676 ],5677 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5678 "variant": "program",5679 "schema_ref": "ProgramToolCallCaller"5680 },5681 {5682 "provider": "openai",5683 "endpoint": "POST /v1/conversations",5684 "parameter": "items[](custom_tool_call).namespace",5685 "location": "body",5686 "type": "string",5687 "required": false,5688 "default": null,5689 "minimum": null,5690 "maximum": null,5691 "enum": null,5692 "description": "The namespace of the custom tool being called.",5693 "compatible_models": [5694 "*"5695 ],5696 "beta_header": null,5697 "status": [5698 "DOCUMENTED"5699 ],5700 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5701 },5702 {5703 "provider": "openai",5704 "endpoint": "POST /v1/conversations",5705 "parameter": "items[](custom_tool_call).name",5706 "location": "body",5707 "type": "string",5708 "required": true,5709 "default": null,5710 "minimum": null,5711 "maximum": null,5712 "enum": null,5713 "description": "The name of the custom tool being called.",5714 "compatible_models": [5715 "*"5716 ],5717 "beta_header": null,5718 "status": [5719 "DOCUMENTED"5720 ],5721 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5722 },5723 {5724 "provider": "openai",5725 "endpoint": "POST /v1/conversations",5726 "parameter": "items[](custom_tool_call).input",5727 "location": "body",5728 "type": "string",5729 "required": true,5730 "default": null,5731 "minimum": null,5732 "maximum": null,5733 "enum": null,5734 "description": "The input for the custom tool call generated by the model.",5735 "compatible_models": [5736 "*"5737 ],5738 "beta_header": null,5739 "status": [5740 "DOCUMENTED"5741 ],5742 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5743 },5744 {5745 "provider": "openai",5746 "endpoint": "POST /v1/conversations",5747 "parameter": "items[](custom_tool_call).async",5748 "location": "body",5749 "type": "boolean",5750 "required": false,5751 "default": null,5752 "minimum": null,5753 "maximum": null,5754 "enum": null,5755 "description": "Whether the custom tool call runs asynchronously.",5756 "compatible_models": [5757 "*"5758 ],5759 "beta_header": null,5760 "status": [5761 "DOCUMENTED"5762 ],5763 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5764 },5765 {5766 "provider": "openai",5767 "endpoint": "POST /v1/conversations",5768 "parameter": "items[](compaction_trigger)",5769 "location": "body",5770 "type": "object",5771 "required": false,5772 "default": null,5773 "minimum": null,5774 "maximum": null,5775 "enum": null,5776 "description": "Compacts the current context. Must be the final input item.",5777 "compatible_models": [5778 "*"5779 ],5780 "beta_header": null,5781 "status": [5782 "DOCUMENTED"5783 ],5784 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5785 "variant": "compaction_trigger",5786 "schema_ref": "CompactionTriggerItemParam"5787 },5788 {5789 "provider": "openai",5790 "endpoint": "POST /v1/conversations",5791 "parameter": "items[](compaction_trigger).id",5792 "location": "body",5793 "type": "string | null",5794 "required": false,5795 "default": null,5796 "minimum": null,5797 "maximum": null,5798 "enum": null,5799 "description": "The unique ID of this compaction trigger.",5800 "compatible_models": [5801 "*"5802 ],5803 "beta_header": null,5804 "status": [5805 "DOCUMENTED"5806 ],5807 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5808 "nullable": true5809 },5810 {5811 "provider": "openai",5812 "endpoint": "POST /v1/conversations",5813 "parameter": "items[](compaction_trigger).type",5814 "location": "body",5815 "type": "string",5816 "required": true,5817 "default": "compaction_trigger",5818 "minimum": null,5819 "maximum": null,5820 "enum": [5821 "compaction_trigger"5822 ],5823 "description": "The type of the item. Always `compaction_trigger`.",5824 "compatible_models": [5825 "*"5826 ],5827 "beta_header": null,5828 "status": [5829 "DOCUMENTED"5830 ],5831 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5832 },5833 {5834 "provider": "openai",5835 "endpoint": "POST /v1/conversations",5836 "parameter": "items[](item_reference)",5837 "location": "body",5838 "type": "object",5839 "required": false,5840 "default": null,5841 "minimum": null,5842 "maximum": null,5843 "enum": null,5844 "description": "An internal identifier for an item to reference.",5845 "compatible_models": [5846 "*"5847 ],5848 "beta_header": null,5849 "status": [5850 "DOCUMENTED"5851 ],5852 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5853 "variant": "ItemReferenceParam",5854 "schema_ref": "ItemReferenceParam"5855 },5856 {5857 "provider": "openai",5858 "endpoint": "POST /v1/conversations",5859 "parameter": "items[](item_reference).type",5860 "location": "body",5861 "type": "string | null",5862 "required": false,5863 "default": "item_reference",5864 "minimum": null,5865 "maximum": null,5866 "enum": [5867 "item_reference"5868 ],5869 "description": "The type of item to reference. Always `item_reference`.",5870 "compatible_models": [5871 "*"5872 ],5873 "beta_header": null,5874 "status": [5875 "DOCUMENTED"5876 ],5877 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5878 "nullable": true5879 },5880 {5881 "provider": "openai",5882 "endpoint": "POST /v1/conversations",5883 "parameter": "items[](item_reference).id",5884 "location": "body",5885 "type": "string",5886 "required": true,5887 "default": null,5888 "minimum": null,5889 "maximum": null,5890 "enum": null,5891 "description": "The ID of the item to reference.",5892 "compatible_models": [5893 "*"5894 ],5895 "beta_header": null,5896 "status": [5897 "DOCUMENTED"5898 ],5899 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5900 },5901 {5902 "provider": "openai",5903 "endpoint": "POST /v1/conversations",5904 "parameter": "items[](program)",5905 "location": "body",5906 "type": "object",5907 "required": false,5908 "default": null,5909 "minimum": null,5910 "maximum": null,5911 "enum": null,5912 "description": "",5913 "compatible_models": [5914 "*"5915 ],5916 "beta_header": null,5917 "status": [5918 "DOCUMENTED"5919 ],5920 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",5921 "variant": "program",5922 "schema_ref": "ProgramItemParam"5923 },5924 {5925 "provider": "openai",5926 "endpoint": "POST /v1/conversations",5927 "parameter": "items[](program).id",5928 "location": "body",5929 "type": "string",5930 "required": true,5931 "default": null,5932 "minimum": null,5933 "maximum": null,5934 "enum": null,5935 "description": "The unique ID of this program item.",5936 "compatible_models": [5937 "*"5938 ],5939 "beta_header": null,5940 "status": [5941 "DOCUMENTED"5942 ],5943 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5944 },5945 {5946 "provider": "openai",5947 "endpoint": "POST /v1/conversations",5948 "parameter": "items[](program).type",5949 "location": "body",5950 "type": "string",5951 "required": true,5952 "default": "program",5953 "minimum": null,5954 "maximum": null,5955 "enum": [5956 "program"5957 ],5958 "description": "The item type. Always `program`.",5959 "compatible_models": [5960 "*"5961 ],5962 "beta_header": null,5963 "status": [5964 "DOCUMENTED"5965 ],5966 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5967 },5968 {5969 "provider": "openai",5970 "endpoint": "POST /v1/conversations",5971 "parameter": "items[](program).call_id",5972 "location": "body",5973 "type": "string",5974 "required": true,5975 "default": null,5976 "minimum": null,5977 "maximum": null,5978 "enum": null,5979 "description": "The stable call ID of the program item.",5980 "compatible_models": [5981 "*"5982 ],5983 "beta_header": null,5984 "status": [5985 "DOCUMENTED"5986 ],5987 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"5988 },5989 {5990 "provider": "openai",5991 "endpoint": "POST /v1/conversations",5992 "parameter": "items[](program).code",5993 "location": "body",5994 "type": "string",5995 "required": true,5996 "default": null,5997 "minimum": null,5998 "maximum": null,5999 "enum": null,6000 "description": "The JavaScript source executed by programmatic tool calling.",6001 "compatible_models": [6002 "*"6003 ],6004 "beta_header": null,6005 "status": [6006 "DOCUMENTED"6007 ],6008 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6009 },6010 {6011 "provider": "openai",6012 "endpoint": "POST /v1/conversations",6013 "parameter": "items[](program).fingerprint",6014 "location": "body",6015 "type": "string",6016 "required": true,6017 "default": null,6018 "minimum": null,6019 "maximum": null,6020 "enum": null,6021 "description": "Opaque program replay fingerprint that must be round-tripped.",6022 "compatible_models": [6023 "*"6024 ],6025 "beta_header": null,6026 "status": [6027 "DOCUMENTED"6028 ],6029 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6030 },6031 {6032 "provider": "openai",6033 "endpoint": "POST /v1/conversations",6034 "parameter": "items[](program_output)",6035 "location": "body",6036 "type": "object",6037 "required": false,6038 "default": null,6039 "minimum": null,6040 "maximum": null,6041 "enum": null,6042 "description": "",6043 "compatible_models": [6044 "*"6045 ],6046 "beta_header": null,6047 "status": [6048 "DOCUMENTED"6049 ],6050 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6051 "variant": "program_output",6052 "schema_ref": "ProgramOutputItemParam"6053 },6054 {6055 "provider": "openai",6056 "endpoint": "POST /v1/conversations",6057 "parameter": "items[](program_output).id",6058 "location": "body",6059 "type": "string",6060 "required": true,6061 "default": null,6062 "minimum": null,6063 "maximum": null,6064 "enum": null,6065 "description": "The unique ID of this program output item.",6066 "compatible_models": [6067 "*"6068 ],6069 "beta_header": null,6070 "status": [6071 "DOCUMENTED"6072 ],6073 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6074 },6075 {6076 "provider": "openai",6077 "endpoint": "POST /v1/conversations",6078 "parameter": "items[](program_output).type",6079 "location": "body",6080 "type": "string",6081 "required": true,6082 "default": "program_output",6083 "minimum": null,6084 "maximum": null,6085 "enum": [6086 "program_output"6087 ],6088 "description": "The item type. Always `program_output`.",6089 "compatible_models": [6090 "*"6091 ],6092 "beta_header": null,6093 "status": [6094 "DOCUMENTED"6095 ],6096 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6097 },6098 {6099 "provider": "openai",6100 "endpoint": "POST /v1/conversations",6101 "parameter": "items[](program_output).call_id",6102 "location": "body",6103 "type": "string",6104 "required": true,6105 "default": null,6106 "minimum": null,6107 "maximum": null,6108 "enum": null,6109 "description": "The call ID of the program item.",6110 "compatible_models": [6111 "*"6112 ],6113 "beta_header": null,6114 "status": [6115 "DOCUMENTED"6116 ],6117 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6118 },6119 {6120 "provider": "openai",6121 "endpoint": "POST /v1/conversations",6122 "parameter": "items[](program_output).result",6123 "location": "body",6124 "type": "string",6125 "required": true,6126 "default": null,6127 "minimum": null,6128 "maximum": null,6129 "enum": null,6130 "description": "The result produced by the program item.",6131 "compatible_models": [6132 "*"6133 ],6134 "beta_header": null,6135 "status": [6136 "DOCUMENTED"6137 ],6138 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6139 },6140 {6141 "provider": "openai",6142 "endpoint": "POST /v1/conversations",6143 "parameter": "items[](program_output).status",6144 "location": "body",6145 "type": "string",6146 "required": true,6147 "default": null,6148 "minimum": null,6149 "maximum": null,6150 "enum": [6151 "completed",6152 "incomplete"6153 ],6154 "description": "The terminal status of the program output.",6155 "compatible_models": [6156 "*"6157 ],6158 "beta_header": null,6159 "status": [6160 "DOCUMENTED"6161 ],6162 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6163 "schema_ref": "ProgramOutputItemStatus"6164 },6165 {6166 "provider": "openai",6167 "endpoint": "POST /v1/conversations",6168 "parameter": "items[](message).content[](input_text)",6169 "location": "body",6170 "type": "object",6171 "required": false,6172 "default": null,6173 "minimum": null,6174 "maximum": null,6175 "enum": null,6176 "description": "A text input to the model.",6177 "compatible_models": [6178 "*"6179 ],6180 "beta_header": null,6181 "status": [6182 "DOCUMENTED",6183 "LIVE_VERIFIED"6184 ],6185 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6186 "variant": "input_text",6187 "schema_ref": "InputTextContent"6188 },6189 {6190 "provider": "openai",6191 "endpoint": "POST /v1/conversations",6192 "parameter": "items[](message).content[](input_text).type",6193 "location": "body",6194 "type": "string",6195 "required": true,6196 "default": "input_text",6197 "minimum": null,6198 "maximum": null,6199 "enum": [6200 "input_text"6201 ],6202 "description": "The type of the input item. Always `input_text`.",6203 "compatible_models": [6204 "*"6205 ],6206 "beta_header": null,6207 "status": [6208 "DOCUMENTED",6209 "LIVE_VERIFIED"6210 ],6211 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6212 },6213 {6214 "provider": "openai",6215 "endpoint": "POST /v1/conversations",6216 "parameter": "items[](message).content[](input_text).text",6217 "location": "body",6218 "type": "string",6219 "required": true,6220 "default": null,6221 "minimum": null,6222 "maximum": null,6223 "enum": null,6224 "description": "The text input to the model.",6225 "compatible_models": [6226 "*"6227 ],6228 "beta_header": null,6229 "status": [6230 "DOCUMENTED",6231 "LIVE_VERIFIED"6232 ],6233 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6234 },6235 {6236 "provider": "openai",6237 "endpoint": "POST /v1/conversations",6238 "parameter": "items[](message).content[](input_text).prompt_cache_breakpoint",6239 "location": "body",6240 "type": "object",6241 "required": false,6242 "default": null,6243 "minimum": null,6244 "maximum": null,6245 "enum": null,6246 "description": "Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.",6247 "compatible_models": [6248 "*"6249 ],6250 "beta_header": null,6251 "status": [6252 "DOCUMENTED"6253 ],6254 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6255 "schema_ref": "PromptCacheBreakpointConfig"6256 },6257 {6258 "provider": "openai",6259 "endpoint": "POST /v1/conversations",6260 "parameter": "items[](message).content[](input_text).prompt_cache_breakpoint.mode",6261 "location": "body",6262 "type": "string",6263 "required": true,6264 "default": "explicit",6265 "minimum": null,6266 "maximum": null,6267 "enum": [6268 "explicit"6269 ],6270 "description": "The breakpoint mode. Always `explicit`.",6271 "compatible_models": [6272 "*"6273 ],6274 "beta_header": null,6275 "status": [6276 "DOCUMENTED"6277 ],6278 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6279 },6280 {6281 "provider": "openai",6282 "endpoint": "POST /v1/conversations",6283 "parameter": "items[](message).content[](input_image)",6284 "location": "body",6285 "type": "object",6286 "required": false,6287 "default": null,6288 "minimum": null,6289 "maximum": null,6290 "enum": null,6291 "description": "An image input to the model. Learn about [image inputs](https://developers.openai.com/api/docs/guides/images-vision).",6292 "compatible_models": [6293 "*"6294 ],6295 "beta_header": null,6296 "status": [6297 "DOCUMENTED"6298 ],6299 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6300 "variant": "input_image",6301 "schema_ref": "InputImageContent"6302 },6303 {6304 "provider": "openai",6305 "endpoint": "POST /v1/conversations",6306 "parameter": "items[](message).content[](input_image).type",6307 "location": "body",6308 "type": "string",6309 "required": true,6310 "default": "input_image",6311 "minimum": null,6312 "maximum": null,6313 "enum": [6314 "input_image"6315 ],6316 "description": "The type of the input item. Always `input_image`.",6317 "compatible_models": [6318 "*"6319 ],6320 "beta_header": null,6321 "status": [6322 "DOCUMENTED"6323 ],6324 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6325 },6326 {6327 "provider": "openai",6328 "endpoint": "POST /v1/conversations",6329 "parameter": "items[](message).content[](input_image).image_url",6330 "location": "body",6331 "type": "string | null",6332 "required": false,6333 "default": null,6334 "minimum": null,6335 "maximum": null,6336 "enum": null,6337 "description": "The URL of the image to be sent to the model. A fully qualified URL or base64 encoded image in a data URL.",6338 "compatible_models": [6339 "*"6340 ],6341 "beta_header": null,6342 "status": [6343 "DOCUMENTED"6344 ],6345 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6346 "nullable": true6347 },6348 {6349 "provider": "openai",6350 "endpoint": "POST /v1/conversations",6351 "parameter": "items[](message).content[](input_image).file_id",6352 "location": "body",6353 "type": "string | null",6354 "required": false,6355 "default": null,6356 "minimum": null,6357 "maximum": null,6358 "enum": null,6359 "description": "The ID of the file to be sent to the model.",6360 "compatible_models": [6361 "*"6362 ],6363 "beta_header": null,6364 "status": [6365 "DOCUMENTED"6366 ],6367 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6368 "nullable": true6369 },6370 {6371 "provider": "openai",6372 "endpoint": "POST /v1/conversations",6373 "parameter": "items[](message).content[](input_image).detail",6374 "location": "body",6375 "type": "string",6376 "required": true,6377 "default": null,6378 "minimum": null,6379 "maximum": null,6380 "enum": [6381 "low",6382 "high",6383 "auto",6384 "original"6385 ],6386 "description": "The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or `original`. Defaults to `auto`.",6387 "compatible_models": [6388 "*"6389 ],6390 "beta_header": null,6391 "status": [6392 "DOCUMENTED"6393 ],6394 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6395 "schema_ref": "ImageDetail"6396 },6397 {6398 "provider": "openai",6399 "endpoint": "POST /v1/conversations",6400 "parameter": "items[](message).content[](input_image).prompt_cache_breakpoint",6401 "location": "body",6402 "type": "object",6403 "required": false,6404 "default": null,6405 "minimum": null,6406 "maximum": null,6407 "enum": null,6408 "description": "Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.",6409 "compatible_models": [6410 "*"6411 ],6412 "beta_header": null,6413 "status": [6414 "DOCUMENTED"6415 ],6416 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6417 "schema_ref": "PromptCacheBreakpointConfig"6418 },6419 {6420 "provider": "openai",6421 "endpoint": "POST /v1/conversations",6422 "parameter": "items[](message).content[](input_image).prompt_cache_breakpoint.mode",6423 "location": "body",6424 "type": "string",6425 "required": true,6426 "default": "explicit",6427 "minimum": null,6428 "maximum": null,6429 "enum": [6430 "explicit"6431 ],6432 "description": "The breakpoint mode. Always `explicit`.",6433 "compatible_models": [6434 "*"6435 ],6436 "beta_header": null,6437 "status": [6438 "DOCUMENTED"6439 ],6440 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6441 },6442 {6443 "provider": "openai",6444 "endpoint": "POST /v1/conversations",6445 "parameter": "items[](message).content[](input_file)",6446 "location": "body",6447 "type": "object",6448 "required": false,6449 "default": null,6450 "minimum": null,6451 "maximum": null,6452 "enum": null,6453 "description": "A file input to the model.",6454 "compatible_models": [6455 "*"6456 ],6457 "beta_header": null,6458 "status": [6459 "DOCUMENTED"6460 ],6461 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6462 "variant": "input_file",6463 "schema_ref": "InputFileContent"6464 },6465 {6466 "provider": "openai",6467 "endpoint": "POST /v1/conversations",6468 "parameter": "items[](message).content[](input_file).type",6469 "location": "body",6470 "type": "string",6471 "required": true,6472 "default": "input_file",6473 "minimum": null,6474 "maximum": null,6475 "enum": [6476 "input_file"6477 ],6478 "description": "The type of the input item. Always `input_file`.",6479 "compatible_models": [6480 "*"6481 ],6482 "beta_header": null,6483 "status": [6484 "DOCUMENTED"6485 ],6486 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6487 },6488 {6489 "provider": "openai",6490 "endpoint": "POST /v1/conversations",6491 "parameter": "items[](message).content[](input_file).file_id",6492 "location": "body",6493 "type": "string | null",6494 "required": false,6495 "default": null,6496 "minimum": null,6497 "maximum": null,6498 "enum": null,6499 "description": "The ID of the file to be sent to the model.",6500 "compatible_models": [6501 "*"6502 ],6503 "beta_header": null,6504 "status": [6505 "DOCUMENTED"6506 ],6507 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6508 "nullable": true6509 },6510 {6511 "provider": "openai",6512 "endpoint": "POST /v1/conversations",6513 "parameter": "items[](message).content[](input_file).filename",6514 "location": "body",6515 "type": "string",6516 "required": false,6517 "default": null,6518 "minimum": null,6519 "maximum": null,6520 "enum": null,6521 "description": "The name of the file to be sent to the model.",6522 "compatible_models": [6523 "*"6524 ],6525 "beta_header": null,6526 "status": [6527 "DOCUMENTED"6528 ],6529 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6530 },6531 {6532 "provider": "openai",6533 "endpoint": "POST /v1/conversations",6534 "parameter": "items[](message).content[](input_file).file_data",6535 "location": "body",6536 "type": "string",6537 "required": false,6538 "default": null,6539 "minimum": null,6540 "maximum": null,6541 "enum": null,6542 "description": "The content of the file to be sent to the model.",6543 "compatible_models": [6544 "*"6545 ],6546 "beta_header": null,6547 "status": [6548 "DOCUMENTED"6549 ],6550 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6551 },6552 {6553 "provider": "openai",6554 "endpoint": "POST /v1/conversations",6555 "parameter": "items[](message).content[](input_file).prompt_cache_breakpoint",6556 "location": "body",6557 "type": "object",6558 "required": false,6559 "default": null,6560 "minimum": null,6561 "maximum": null,6562 "enum": null,6563 "description": "Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.",6564 "compatible_models": [6565 "*"6566 ],6567 "beta_header": null,6568 "status": [6569 "DOCUMENTED"6570 ],6571 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6572 "schema_ref": "PromptCacheBreakpointConfig"6573 },6574 {6575 "provider": "openai",6576 "endpoint": "POST /v1/conversations",6577 "parameter": "items[](message).content[](input_file).prompt_cache_breakpoint.mode",6578 "location": "body",6579 "type": "string",6580 "required": true,6581 "default": "explicit",6582 "minimum": null,6583 "maximum": null,6584 "enum": [6585 "explicit"6586 ],6587 "description": "The breakpoint mode. Always `explicit`.",6588 "compatible_models": [6589 "*"6590 ],6591 "beta_header": null,6592 "status": [6593 "DOCUMENTED"6594 ],6595 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6596 },6597 {6598 "provider": "openai",6599 "endpoint": "POST /v1/conversations",6600 "parameter": "items[](message).content[](input_file).file_url",6601 "location": "body",6602 "type": "string",6603 "required": false,6604 "default": null,6605 "minimum": null,6606 "maximum": null,6607 "enum": null,6608 "description": "The URL of the file to be sent to the model.",6609 "compatible_models": [6610 "*"6611 ],6612 "beta_header": null,6613 "status": [6614 "DOCUMENTED"6615 ],6616 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create"6617 },6618 {6619 "provider": "openai",6620 "endpoint": "POST /v1/conversations",6621 "parameter": "items[](message).content[](input_file).detail",6622 "location": "body",6623 "type": "string",6624 "required": false,6625 "default": null,6626 "minimum": null,6627 "maximum": null,6628 "enum": [6629 "auto",6630 "low",6631 "high"6632 ],6633 "description": "The detail level of the file to be sent to the model. Use `auto` to let the system select the detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which may increase input token usage. Use `low` for lower-cost rendering, or `high` to render the file at higher quality. Defaults to `auto`.",6634 "compatible_models": [6635 "*"6636 ],6637 "beta_header": null,6638 "status": [6639 "DOCUMENTED"6640 ],6641 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/create",6642 "schema_ref": "FileInputDetail"6643 },6644 {6645 "provider": "openai",6646 "endpoint": "POST /v1/conversations/{conversation_id}/items",6647 "parameter": "items",6648 "location": "body",6649 "type": "array<object<message> | object<message> | object<file_search_call> | object<computer_call> | object<computer_call_output> | object<web_search_call> | object<function_call> | object<function_call_output> | object<tool_search_call> | object<tool_search_output> | object<additional_tools> | object<configuration_update> | object<reasoning> | object<compaction> | object<image_generation_call> | object<code_interpreter_call> | object<local_shell_call> | object<local_shell_call_output> | object<shell_call> | object<shell_call_output> | object<apply_patch_call> | object<apply_patch_call_output> | object<mcp_list_tools> | object<mcp_approval_request> | object<mcp_approval_response> | object<mcp_call> | object<custom_tool_call_output> | object<custom_tool_call> | object<compaction_trigger> | ItemReferenceParam | object<program> | object<program_output>>",6650 "required": true,6651 "default": null,6652 "minimum": null,6653 "maximum": null,6654 "enum": null,6655 "description": "Initial items to include in the conversation context. You may add up to 20 items at a time.",6656 "compatible_models": [6657 "*"6658 ],6659 "beta_header": null,6660 "status": [6661 "DOCUMENTED",6662 "LIVE_VERIFIED"6663 ],6664 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",6665 "nullable": true6666 },6667 {6668 "provider": "openai",6669 "endpoint": "POST /v1/conversations/{conversation_id}/items",6670 "parameter": "items[]",6671 "location": "body",6672 "type": "object<message> | object<file_search_call> | object<computer_call> | object<computer_call_output> | object<web_search_call> | object<function_call> | object<function_call_output> | object<tool_search_call> | object<tool_search_output> | object<additional_tools> | object<configuration_update> | object<reasoning> | object<compaction> | object<image_generation_call> | object<code_interpreter_call> | object<local_shell_call> | object<local_shell_call_output> | object<shell_call> | object<shell_call_output> | object<apply_patch_call> | object<apply_patch_call_output> | object<mcp_list_tools> | object<mcp_approval_request> | object<mcp_approval_response> | object<mcp_call> | object<custom_tool_call_output> | object<custom_tool_call> | object<compaction_trigger> | ItemReferenceParam | object<program> | object<program_output>",6673 "required": false,6674 "default": null,6675 "minimum": null,6676 "maximum": null,6677 "enum": null,6678 "description": "An item representing part of the context for the response to be generated by the model. Can contain text, images, and audio inputs, as well as previous assistant responses and tool call outputs.",6679 "compatible_models": [6680 "*"6681 ],6682 "beta_header": null,6683 "status": [6684 "DOCUMENTED",6685 "LIVE_VERIFIED"6686 ],6687 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",6688 "schema_ref": "InputItem"6689 },6690 {6691 "provider": "openai",6692 "endpoint": "POST /v1/conversations/{conversation_id}/items",6693 "parameter": "items[](message)",6694 "location": "body",6695 "type": "object",6696 "required": false,6697 "default": null,6698 "minimum": null,6699 "maximum": null,6700 "enum": null,6701 "description": "A message input to the model with a role indicating instruction following hierarchy. Instructions given with the `developer` or `system` role take precedence over instructions given with the `user` role. Messages with the `assistant` role are presumed to have been generated by the model in previous interactions.",6702 "compatible_models": [6703 "*"6704 ],6705 "beta_header": null,6706 "status": [6707 "DOCUMENTED",6708 "LIVE_VERIFIED"6709 ],6710 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",6711 "variant": "message",6712 "schema_ref": "EasyInputMessage"6713 },6714 {6715 "provider": "openai",6716 "endpoint": "POST /v1/conversations/{conversation_id}/items",6717 "parameter": "items[](message).role",6718 "location": "body",6719 "type": "string",6720 "required": true,6721 "default": null,6722 "minimum": null,6723 "maximum": null,6724 "enum": [6725 "user",6726 "assistant",6727 "system",6728 "developer"6729 ],6730 "description": "The role of the message input. One of `user`, `assistant`, `system`, or `developer`.",6731 "compatible_models": [6732 "*"6733 ],6734 "beta_header": null,6735 "status": [6736 "DOCUMENTED",6737 "LIVE_VERIFIED"6738 ],6739 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"6740 },6741 {6742 "provider": "openai",6743 "endpoint": "POST /v1/conversations/{conversation_id}/items",6744 "parameter": "items[](message).content",6745 "location": "body",6746 "type": "string | array<object<input_text> | object<input_image> | object<input_file>> | array<object<output_text> | object<refusal>>",6747 "required": true,6748 "default": null,6749 "minimum": null,6750 "maximum": null,6751 "enum": null,6752 "description": "Text, image, or audio input to the model, used to generate a response. Can also contain previous assistant responses.",6753 "compatible_models": [6754 "*"6755 ],6756 "beta_header": null,6757 "status": [6758 "DOCUMENTED",6759 "LIVE_VERIFIED"6760 ],6761 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"6762 },6763 {6764 "provider": "openai",6765 "endpoint": "POST /v1/conversations/{conversation_id}/items",6766 "parameter": "items[](message).content[]",6767 "location": "body",6768 "type": "array<object<input_text> | object<input_image> | object<input_file>> | object<input_text> | object<input_file> | object<output_text> | object<refusal>",6769 "required": false,6770 "default": null,6771 "minimum": null,6772 "maximum": null,6773 "enum": null,6774 "description": "A list of one or many input items to the model, containing different content types.",6775 "compatible_models": [6776 "*"6777 ],6778 "beta_header": null,6779 "status": [6780 "DOCUMENTED",6781 "LIVE_VERIFIED"6782 ],6783 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",6784 "schema_ref": "InputMessageContentList"6785 },6786 {6787 "provider": "openai",6788 "endpoint": "POST /v1/conversations/{conversation_id}/items",6789 "parameter": "items[](message).phase",6790 "location": "body",6791 "type": "string | null",6792 "required": false,6793 "default": null,6794 "minimum": null,6795 "maximum": null,6796 "enum": [6797 "commentary",6798 "final_answer"6799 ],6800 "description": "Labels an `assistant` message as intermediate commentary (`commentary`) or the final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending follow-up requests, preserve and resend phase on all assistant messages — dropping it can degrade performance. Not used for user messages.",6801 "compatible_models": [6802 "*"6803 ],6804 "beta_header": null,6805 "status": [6806 "DOCUMENTED"6807 ],6808 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",6809 "nullable": true6810 },6811 {6812 "provider": "openai",6813 "endpoint": "POST /v1/conversations/{conversation_id}/items",6814 "parameter": "items[](message).type",6815 "location": "body",6816 "type": "string",6817 "required": true,6818 "default": null,6819 "minimum": null,6820 "maximum": null,6821 "enum": [6822 "message"6823 ],6824 "description": "The type of the message input. Always `message`.",6825 "compatible_models": [6826 "*"6827 ],6828 "beta_header": null,6829 "status": [6830 "DOCUMENTED",6831 "LIVE_VERIFIED"6832 ],6833 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"6834 },6835 {6836 "provider": "openai",6837 "endpoint": "POST /v1/conversations/{conversation_id}/items",6838 "parameter": "items[](message).status",6839 "location": "body",6840 "type": "string",6841 "required": true,6842 "default": null,6843 "minimum": null,6844 "maximum": null,6845 "enum": [6846 "in_progress",6847 "completed",6848 "incomplete"6849 ],6850 "description": "The status of item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.",6851 "compatible_models": [6852 "*"6853 ],6854 "beta_header": null,6855 "status": [6856 "DOCUMENTED"6857 ],6858 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"6859 },6860 {6861 "provider": "openai",6862 "endpoint": "POST /v1/conversations/{conversation_id}/items",6863 "parameter": "items[](message).id",6864 "location": "body",6865 "type": "string",6866 "required": true,6867 "default": null,6868 "minimum": null,6869 "maximum": null,6870 "enum": null,6871 "description": "The unique ID of the output message.",6872 "compatible_models": [6873 "*"6874 ],6875 "beta_header": null,6876 "status": [6877 "DOCUMENTED"6878 ],6879 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"6880 },6881 {6882 "provider": "openai",6883 "endpoint": "POST /v1/conversations/{conversation_id}/items",6884 "parameter": "items[](file_search_call)",6885 "location": "body",6886 "type": "object",6887 "required": false,6888 "default": null,6889 "minimum": null,6890 "maximum": null,6891 "enum": null,6892 "description": "The results of a file search tool call. See the [file search guide](https://developers.openai.com/api/docs/guides/tools-file-search) for more information.",6893 "compatible_models": [6894 "*"6895 ],6896 "beta_header": null,6897 "status": [6898 "DOCUMENTED"6899 ],6900 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",6901 "variant": "file_search_call",6902 "schema_ref": "FileSearchToolCall"6903 },6904 {6905 "provider": "openai",6906 "endpoint": "POST /v1/conversations/{conversation_id}/items",6907 "parameter": "items[](file_search_call).id",6908 "location": "body",6909 "type": "string",6910 "required": true,6911 "default": null,6912 "minimum": null,6913 "maximum": null,6914 "enum": null,6915 "description": "The unique ID of the file search tool call.",6916 "compatible_models": [6917 "*"6918 ],6919 "beta_header": null,6920 "status": [6921 "DOCUMENTED"6922 ],6923 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"6924 },6925 {6926 "provider": "openai",6927 "endpoint": "POST /v1/conversations/{conversation_id}/items",6928 "parameter": "items[](file_search_call).type",6929 "location": "body",6930 "type": "string",6931 "required": true,6932 "default": null,6933 "minimum": null,6934 "maximum": null,6935 "enum": [6936 "file_search_call"6937 ],6938 "description": "The type of the file search tool call. Always `file_search_call`.",6939 "compatible_models": [6940 "*"6941 ],6942 "beta_header": null,6943 "status": [6944 "DOCUMENTED"6945 ],6946 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"6947 },6948 {6949 "provider": "openai",6950 "endpoint": "POST /v1/conversations/{conversation_id}/items",6951 "parameter": "items[](file_search_call).status",6952 "location": "body",6953 "type": "string",6954 "required": true,6955 "default": null,6956 "minimum": null,6957 "maximum": null,6958 "enum": [6959 "in_progress",6960 "searching",6961 "completed",6962 "incomplete",6963 "failed"6964 ],6965 "description": "The status of the file search tool call. One of `in_progress`, `searching`, `incomplete` or `failed`,",6966 "compatible_models": [6967 "*"6968 ],6969 "beta_header": null,6970 "status": [6971 "DOCUMENTED"6972 ],6973 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"6974 },6975 {6976 "provider": "openai",6977 "endpoint": "POST /v1/conversations/{conversation_id}/items",6978 "parameter": "items[](file_search_call).queries",6979 "location": "body",6980 "type": "array<string>",6981 "required": true,6982 "default": null,6983 "minimum": null,6984 "maximum": null,6985 "enum": null,6986 "description": "The queries used to search for files.",6987 "compatible_models": [6988 "*"6989 ],6990 "beta_header": null,6991 "status": [6992 "DOCUMENTED"6993 ],6994 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"6995 },6996 {6997 "provider": "openai",6998 "endpoint": "POST /v1/conversations/{conversation_id}/items",6999 "parameter": "items[](file_search_call).queries[]",7000 "location": "body",7001 "type": "string",7002 "required": false,7003 "default": null,7004 "minimum": null,7005 "maximum": null,7006 "enum": null,7007 "description": "",7008 "compatible_models": [7009 "*"7010 ],7011 "beta_header": null,7012 "status": [7013 "DOCUMENTED"7014 ],7015 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7016 },7017 {7018 "provider": "openai",7019 "endpoint": "POST /v1/conversations/{conversation_id}/items",7020 "parameter": "items[](file_search_call).results",7021 "location": "body",7022 "type": "array<object>",7023 "required": false,7024 "default": null,7025 "minimum": null,7026 "maximum": null,7027 "enum": null,7028 "description": "The results of the file search tool call.",7029 "compatible_models": [7030 "*"7031 ],7032 "beta_header": null,7033 "status": [7034 "DOCUMENTED"7035 ],7036 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7037 "nullable": true7038 },7039 {7040 "provider": "openai",7041 "endpoint": "POST /v1/conversations/{conversation_id}/items",7042 "parameter": "items[](file_search_call).results[]",7043 "location": "body",7044 "type": "object",7045 "required": false,7046 "default": null,7047 "minimum": null,7048 "maximum": null,7049 "enum": null,7050 "description": "",7051 "compatible_models": [7052 "*"7053 ],7054 "beta_header": null,7055 "status": [7056 "DOCUMENTED"7057 ],7058 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7059 },7060 {7061 "provider": "openai",7062 "endpoint": "POST /v1/conversations/{conversation_id}/items",7063 "parameter": "items[](computer_call)",7064 "location": "body",7065 "type": "object",7066 "required": false,7067 "default": null,7068 "minimum": null,7069 "maximum": null,7070 "enum": null,7071 "description": "A tool call to a computer use tool. See the [computer use guide](https://developers.openai.com/api/docs/guides/tools-computer-use) for more information.",7072 "compatible_models": [7073 "*"7074 ],7075 "beta_header": null,7076 "status": [7077 "DOCUMENTED"7078 ],7079 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7080 "variant": "computer_call",7081 "schema_ref": "ComputerToolCall"7082 },7083 {7084 "provider": "openai",7085 "endpoint": "POST /v1/conversations/{conversation_id}/items",7086 "parameter": "items[](computer_call).type",7087 "location": "body",7088 "type": "string",7089 "required": true,7090 "default": "computer_call",7091 "minimum": null,7092 "maximum": null,7093 "enum": [7094 "computer_call"7095 ],7096 "description": "The type of the computer call. Always `computer_call`.",7097 "compatible_models": [7098 "*"7099 ],7100 "beta_header": null,7101 "status": [7102 "DOCUMENTED"7103 ],7104 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7105 },7106 {7107 "provider": "openai",7108 "endpoint": "POST /v1/conversations/{conversation_id}/items",7109 "parameter": "items[](computer_call).id",7110 "location": "body",7111 "type": "string",7112 "required": true,7113 "default": null,7114 "minimum": null,7115 "maximum": null,7116 "enum": null,7117 "description": "The unique ID of the computer call.",7118 "compatible_models": [7119 "*"7120 ],7121 "beta_header": null,7122 "status": [7123 "DOCUMENTED"7124 ],7125 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7126 },7127 {7128 "provider": "openai",7129 "endpoint": "POST /v1/conversations/{conversation_id}/items",7130 "parameter": "items[](computer_call).call_id",7131 "location": "body",7132 "type": "string",7133 "required": true,7134 "default": null,7135 "minimum": null,7136 "maximum": null,7137 "enum": null,7138 "description": "An identifier used when responding to the tool call with output.",7139 "compatible_models": [7140 "*"7141 ],7142 "beta_header": null,7143 "status": [7144 "DOCUMENTED"7145 ],7146 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7147 },7148 {7149 "provider": "openai",7150 "endpoint": "POST /v1/conversations/{conversation_id}/items",7151 "parameter": "items[](computer_call).action",7152 "location": "body",7153 "type": "object<click> | object<double_click> | object<drag> | object<keypress> | object<move> | object<screenshot> | object<scroll> | object<type> | object<wait>",7154 "required": false,7155 "default": null,7156 "minimum": null,7157 "maximum": null,7158 "enum": null,7159 "description": "",7160 "compatible_models": [7161 "*"7162 ],7163 "beta_header": null,7164 "status": [7165 "DOCUMENTED"7166 ],7167 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7168 "schema_ref": "ComputerAction"7169 },7170 {7171 "provider": "openai",7172 "endpoint": "POST /v1/conversations/{conversation_id}/items",7173 "parameter": "items[](computer_call).action(click)",7174 "location": "body",7175 "type": "object",7176 "required": false,7177 "default": null,7178 "minimum": null,7179 "maximum": null,7180 "enum": null,7181 "description": "A click action.",7182 "compatible_models": [7183 "*"7184 ],7185 "beta_header": null,7186 "status": [7187 "DOCUMENTED"7188 ],7189 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7190 "variant": "click",7191 "schema_ref": "ClickParam"7192 },7193 {7194 "provider": "openai",7195 "endpoint": "POST /v1/conversations/{conversation_id}/items",7196 "parameter": "items[](computer_call).action(double_click)",7197 "location": "body",7198 "type": "object",7199 "required": false,7200 "default": null,7201 "minimum": null,7202 "maximum": null,7203 "enum": null,7204 "description": "A double click action.",7205 "compatible_models": [7206 "*"7207 ],7208 "beta_header": null,7209 "status": [7210 "DOCUMENTED"7211 ],7212 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7213 "variant": "double_click",7214 "schema_ref": "DoubleClickAction"7215 },7216 {7217 "provider": "openai",7218 "endpoint": "POST /v1/conversations/{conversation_id}/items",7219 "parameter": "items[](computer_call).action(drag)",7220 "location": "body",7221 "type": "object",7222 "required": false,7223 "default": null,7224 "minimum": null,7225 "maximum": null,7226 "enum": null,7227 "description": "A drag action.",7228 "compatible_models": [7229 "*"7230 ],7231 "beta_header": null,7232 "status": [7233 "DOCUMENTED"7234 ],7235 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7236 "variant": "drag",7237 "schema_ref": "DragParam"7238 },7239 {7240 "provider": "openai",7241 "endpoint": "POST /v1/conversations/{conversation_id}/items",7242 "parameter": "items[](computer_call).action(keypress)",7243 "location": "body",7244 "type": "object",7245 "required": false,7246 "default": null,7247 "minimum": null,7248 "maximum": null,7249 "enum": null,7250 "description": "A collection of keypresses the model would like to perform.",7251 "compatible_models": [7252 "*"7253 ],7254 "beta_header": null,7255 "status": [7256 "DOCUMENTED"7257 ],7258 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7259 "variant": "keypress",7260 "schema_ref": "KeyPressAction"7261 },7262 {7263 "provider": "openai",7264 "endpoint": "POST /v1/conversations/{conversation_id}/items",7265 "parameter": "items[](computer_call).action(move)",7266 "location": "body",7267 "type": "object",7268 "required": false,7269 "default": null,7270 "minimum": null,7271 "maximum": null,7272 "enum": null,7273 "description": "A mouse move action.",7274 "compatible_models": [7275 "*"7276 ],7277 "beta_header": null,7278 "status": [7279 "DOCUMENTED"7280 ],7281 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7282 "variant": "move",7283 "schema_ref": "MoveParam"7284 },7285 {7286 "provider": "openai",7287 "endpoint": "POST /v1/conversations/{conversation_id}/items",7288 "parameter": "items[](computer_call).action(screenshot)",7289 "location": "body",7290 "type": "object",7291 "required": false,7292 "default": null,7293 "minimum": null,7294 "maximum": null,7295 "enum": null,7296 "description": "A screenshot action.",7297 "compatible_models": [7298 "*"7299 ],7300 "beta_header": null,7301 "status": [7302 "DOCUMENTED"7303 ],7304 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7305 "variant": "screenshot",7306 "schema_ref": "ScreenshotParam"7307 },7308 {7309 "provider": "openai",7310 "endpoint": "POST /v1/conversations/{conversation_id}/items",7311 "parameter": "items[](computer_call).action(scroll)",7312 "location": "body",7313 "type": "object",7314 "required": false,7315 "default": null,7316 "minimum": null,7317 "maximum": null,7318 "enum": null,7319 "description": "A scroll action.",7320 "compatible_models": [7321 "*"7322 ],7323 "beta_header": null,7324 "status": [7325 "DOCUMENTED"7326 ],7327 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7328 "variant": "scroll",7329 "schema_ref": "ScrollParam"7330 },7331 {7332 "provider": "openai",7333 "endpoint": "POST /v1/conversations/{conversation_id}/items",7334 "parameter": "items[](computer_call).action(type)",7335 "location": "body",7336 "type": "object",7337 "required": false,7338 "default": null,7339 "minimum": null,7340 "maximum": null,7341 "enum": null,7342 "description": "An action to type in text.",7343 "compatible_models": [7344 "*"7345 ],7346 "beta_header": null,7347 "status": [7348 "DOCUMENTED"7349 ],7350 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7351 "variant": "type",7352 "schema_ref": "TypeParam"7353 },7354 {7355 "provider": "openai",7356 "endpoint": "POST /v1/conversations/{conversation_id}/items",7357 "parameter": "items[](computer_call).action(wait)",7358 "location": "body",7359 "type": "object",7360 "required": false,7361 "default": null,7362 "minimum": null,7363 "maximum": null,7364 "enum": null,7365 "description": "A wait action.",7366 "compatible_models": [7367 "*"7368 ],7369 "beta_header": null,7370 "status": [7371 "DOCUMENTED"7372 ],7373 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7374 "variant": "wait",7375 "schema_ref": "WaitParam"7376 },7377 {7378 "provider": "openai",7379 "endpoint": "POST /v1/conversations/{conversation_id}/items",7380 "parameter": "items[](computer_call).actions",7381 "location": "body",7382 "type": "array<object<click> | object<double_click> | object<drag> | object<keypress> | object<move> | object<screenshot> | object<scroll> | object<type> | object<wait>>",7383 "required": false,7384 "default": null,7385 "minimum": null,7386 "maximum": null,7387 "enum": null,7388 "description": "Flattened batched actions for `computer_use`. Each action includes an `type` discriminator and action-specific fields.",7389 "compatible_models": [7390 "*"7391 ],7392 "beta_header": null,7393 "status": [7394 "DOCUMENTED"7395 ],7396 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7397 "schema_ref": "ComputerActionList"7398 },7399 {7400 "provider": "openai",7401 "endpoint": "POST /v1/conversations/{conversation_id}/items",7402 "parameter": "items[](computer_call).actions[]",7403 "location": "body",7404 "type": "object<click> | object<double_click> | object<drag> | object<keypress> | object<move> | object<screenshot> | object<scroll> | object<type> | object<wait>",7405 "required": false,7406 "default": null,7407 "minimum": null,7408 "maximum": null,7409 "enum": null,7410 "description": "",7411 "compatible_models": [7412 "*"7413 ],7414 "beta_header": null,7415 "status": [7416 "DOCUMENTED"7417 ],7418 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7419 "schema_ref": "ComputerAction"7420 },7421 {7422 "provider": "openai",7423 "endpoint": "POST /v1/conversations/{conversation_id}/items",7424 "parameter": "items[](computer_call).pending_safety_checks",7425 "location": "body",7426 "type": "array<object>",7427 "required": true,7428 "default": null,7429 "minimum": null,7430 "maximum": null,7431 "enum": null,7432 "description": "The pending safety checks for the computer call.",7433 "compatible_models": [7434 "*"7435 ],7436 "beta_header": null,7437 "status": [7438 "DOCUMENTED"7439 ],7440 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7441 },7442 {7443 "provider": "openai",7444 "endpoint": "POST /v1/conversations/{conversation_id}/items",7445 "parameter": "items[](computer_call).pending_safety_checks[]",7446 "location": "body",7447 "type": "object",7448 "required": false,7449 "default": null,7450 "minimum": null,7451 "maximum": null,7452 "enum": null,7453 "description": "A pending safety check for the computer call.",7454 "compatible_models": [7455 "*"7456 ],7457 "beta_header": null,7458 "status": [7459 "DOCUMENTED"7460 ],7461 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7462 "schema_ref": "ComputerCallSafetyCheckParam"7463 },7464 {7465 "provider": "openai",7466 "endpoint": "POST /v1/conversations/{conversation_id}/items",7467 "parameter": "items[](computer_call).status",7468 "location": "body",7469 "type": "string",7470 "required": true,7471 "default": null,7472 "minimum": null,7473 "maximum": null,7474 "enum": [7475 "in_progress",7476 "completed",7477 "incomplete"7478 ],7479 "description": "The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.",7480 "compatible_models": [7481 "*"7482 ],7483 "beta_header": null,7484 "status": [7485 "DOCUMENTED"7486 ],7487 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7488 },7489 {7490 "provider": "openai",7491 "endpoint": "POST /v1/conversations/{conversation_id}/items",7492 "parameter": "items[](computer_call_output)",7493 "location": "body",7494 "type": "object",7495 "required": false,7496 "default": null,7497 "minimum": null,7498 "maximum": null,7499 "enum": null,7500 "description": "The output of a computer tool call.",7501 "compatible_models": [7502 "*"7503 ],7504 "beta_header": null,7505 "status": [7506 "DOCUMENTED"7507 ],7508 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7509 "variant": "computer_call_output",7510 "schema_ref": "ComputerCallOutputItemParam"7511 },7512 {7513 "provider": "openai",7514 "endpoint": "POST /v1/conversations/{conversation_id}/items",7515 "parameter": "items[](computer_call_output).id",7516 "location": "body",7517 "type": "string | null",7518 "required": false,7519 "default": null,7520 "minimum": null,7521 "maximum": null,7522 "enum": null,7523 "description": "The ID of the computer tool call output.",7524 "compatible_models": [7525 "*"7526 ],7527 "beta_header": null,7528 "status": [7529 "DOCUMENTED"7530 ],7531 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7532 "nullable": true7533 },7534 {7535 "provider": "openai",7536 "endpoint": "POST /v1/conversations/{conversation_id}/items",7537 "parameter": "items[](computer_call_output).call_id",7538 "location": "body",7539 "type": "string",7540 "required": true,7541 "default": null,7542 "minimum": null,7543 "maximum": null,7544 "enum": null,7545 "description": "The ID of the computer tool call that produced the output.",7546 "compatible_models": [7547 "*"7548 ],7549 "beta_header": null,7550 "status": [7551 "DOCUMENTED"7552 ],7553 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7554 },7555 {7556 "provider": "openai",7557 "endpoint": "POST /v1/conversations/{conversation_id}/items",7558 "parameter": "items[](computer_call_output).type",7559 "location": "body",7560 "type": "string",7561 "required": true,7562 "default": "computer_call_output",7563 "minimum": null,7564 "maximum": null,7565 "enum": [7566 "computer_call_output"7567 ],7568 "description": "The type of the computer tool call output. Always `computer_call_output`.",7569 "compatible_models": [7570 "*"7571 ],7572 "beta_header": null,7573 "status": [7574 "DOCUMENTED"7575 ],7576 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7577 },7578 {7579 "provider": "openai",7580 "endpoint": "POST /v1/conversations/{conversation_id}/items",7581 "parameter": "items[](computer_call_output).output",7582 "location": "body",7583 "type": "object",7584 "required": true,7585 "default": null,7586 "minimum": null,7587 "maximum": null,7588 "enum": null,7589 "description": "A computer screenshot image used with the computer use tool.",7590 "compatible_models": [7591 "*"7592 ],7593 "beta_header": null,7594 "status": [7595 "DOCUMENTED"7596 ],7597 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7598 "schema_ref": "ComputerScreenshotImage"7599 },7600 {7601 "provider": "openai",7602 "endpoint": "POST /v1/conversations/{conversation_id}/items",7603 "parameter": "items[](computer_call_output).output.type",7604 "location": "body",7605 "type": "string",7606 "required": true,7607 "default": "computer_screenshot",7608 "minimum": null,7609 "maximum": null,7610 "enum": [7611 "computer_screenshot"7612 ],7613 "description": "Specifies the event type. For a computer screenshot, this property is always set to `computer_screenshot`.",7614 "compatible_models": [7615 "*"7616 ],7617 "beta_header": null,7618 "status": [7619 "DOCUMENTED"7620 ],7621 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7622 },7623 {7624 "provider": "openai",7625 "endpoint": "POST /v1/conversations/{conversation_id}/items",7626 "parameter": "items[](computer_call_output).output.image_url",7627 "location": "body",7628 "type": "string",7629 "required": false,7630 "default": null,7631 "minimum": null,7632 "maximum": null,7633 "enum": null,7634 "description": "The URL of the screenshot image.",7635 "compatible_models": [7636 "*"7637 ],7638 "beta_header": null,7639 "status": [7640 "DOCUMENTED"7641 ],7642 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7643 },7644 {7645 "provider": "openai",7646 "endpoint": "POST /v1/conversations/{conversation_id}/items",7647 "parameter": "items[](computer_call_output).output.file_id",7648 "location": "body",7649 "type": "string",7650 "required": false,7651 "default": null,7652 "minimum": null,7653 "maximum": null,7654 "enum": null,7655 "description": "The identifier of an uploaded file that contains the screenshot.",7656 "compatible_models": [7657 "*"7658 ],7659 "beta_header": null,7660 "status": [7661 "DOCUMENTED"7662 ],7663 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7664 },7665 {7666 "provider": "openai",7667 "endpoint": "POST /v1/conversations/{conversation_id}/items",7668 "parameter": "items[](computer_call_output).acknowledged_safety_checks",7669 "location": "body",7670 "type": "array<object>",7671 "required": false,7672 "default": null,7673 "minimum": null,7674 "maximum": null,7675 "enum": null,7676 "description": "The safety checks reported by the API that have been acknowledged by the developer.",7677 "compatible_models": [7678 "*"7679 ],7680 "beta_header": null,7681 "status": [7682 "DOCUMENTED"7683 ],7684 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7685 "nullable": true7686 },7687 {7688 "provider": "openai",7689 "endpoint": "POST /v1/conversations/{conversation_id}/items",7690 "parameter": "items[](computer_call_output).acknowledged_safety_checks[]",7691 "location": "body",7692 "type": "object",7693 "required": false,7694 "default": null,7695 "minimum": null,7696 "maximum": null,7697 "enum": null,7698 "description": "A pending safety check for the computer call.",7699 "compatible_models": [7700 "*"7701 ],7702 "beta_header": null,7703 "status": [7704 "DOCUMENTED"7705 ],7706 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7707 "schema_ref": "ComputerCallSafetyCheckParam"7708 },7709 {7710 "provider": "openai",7711 "endpoint": "POST /v1/conversations/{conversation_id}/items",7712 "parameter": "items[](computer_call_output).status",7713 "location": "body",7714 "type": "string | null",7715 "required": false,7716 "default": null,7717 "minimum": null,7718 "maximum": null,7719 "enum": [7720 "in_progress",7721 "completed",7722 "incomplete"7723 ],7724 "description": "The status of the message input. One of `in_progress`, `completed`, or `incomplete`. Populated when input items are returned via API.",7725 "compatible_models": [7726 "*"7727 ],7728 "beta_header": null,7729 "status": [7730 "DOCUMENTED"7731 ],7732 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7733 "nullable": true7734 },7735 {7736 "provider": "openai",7737 "endpoint": "POST /v1/conversations/{conversation_id}/items",7738 "parameter": "items[](web_search_call)",7739 "location": "body",7740 "type": "object",7741 "required": false,7742 "default": null,7743 "minimum": null,7744 "maximum": null,7745 "enum": null,7746 "description": "The results of a web search tool call. See the [web search guide](https://developers.openai.com/api/docs/guides/tools-web-search) for more information.",7747 "compatible_models": [7748 "*"7749 ],7750 "beta_header": null,7751 "status": [7752 "DOCUMENTED"7753 ],7754 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7755 "variant": "web_search_call",7756 "schema_ref": "WebSearchToolCall"7757 },7758 {7759 "provider": "openai",7760 "endpoint": "POST /v1/conversations/{conversation_id}/items",7761 "parameter": "items[](web_search_call).id",7762 "location": "body",7763 "type": "string",7764 "required": true,7765 "default": null,7766 "minimum": null,7767 "maximum": null,7768 "enum": null,7769 "description": "The unique ID of the web search tool call.",7770 "compatible_models": [7771 "*"7772 ],7773 "beta_header": null,7774 "status": [7775 "DOCUMENTED"7776 ],7777 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7778 },7779 {7780 "provider": "openai",7781 "endpoint": "POST /v1/conversations/{conversation_id}/items",7782 "parameter": "items[](web_search_call).type",7783 "location": "body",7784 "type": "string",7785 "required": true,7786 "default": null,7787 "minimum": null,7788 "maximum": null,7789 "enum": [7790 "web_search_call"7791 ],7792 "description": "The type of the web search tool call. Always `web_search_call`.",7793 "compatible_models": [7794 "*"7795 ],7796 "beta_header": null,7797 "status": [7798 "DOCUMENTED"7799 ],7800 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7801 },7802 {7803 "provider": "openai",7804 "endpoint": "POST /v1/conversations/{conversation_id}/items",7805 "parameter": "items[](web_search_call).status",7806 "location": "body",7807 "type": "string",7808 "required": true,7809 "default": null,7810 "minimum": null,7811 "maximum": null,7812 "enum": [7813 "in_progress",7814 "searching",7815 "completed",7816 "failed",7817 "incomplete"7818 ],7819 "description": "The status of the web search tool call.",7820 "compatible_models": [7821 "*"7822 ],7823 "beta_header": null,7824 "status": [7825 "DOCUMENTED"7826 ],7827 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7828 "schema_ref": "WebSearchCallStatus"7829 },7830 {7831 "provider": "openai",7832 "endpoint": "POST /v1/conversations/{conversation_id}/items",7833 "parameter": "items[](web_search_call).action",7834 "location": "body",7835 "type": "object<search> | object<open_page> | object<find_in_page>",7836 "required": true,7837 "default": null,7838 "minimum": null,7839 "maximum": null,7840 "enum": null,7841 "description": "An object describing the specific action taken in this web search call. Includes details on how the model used the web (search, open_page, find_in_page).",7842 "compatible_models": [7843 "*"7844 ],7845 "beta_header": null,7846 "status": [7847 "DOCUMENTED"7848 ],7849 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7850 },7851 {7852 "provider": "openai",7853 "endpoint": "POST /v1/conversations/{conversation_id}/items",7854 "parameter": "items[](web_search_call).action(search)",7855 "location": "body",7856 "type": "object",7857 "required": true,7858 "default": null,7859 "minimum": null,7860 "maximum": null,7861 "enum": null,7862 "description": "Action type \"search\" - Performs a web search query.",7863 "compatible_models": [7864 "*"7865 ],7866 "beta_header": null,7867 "status": [7868 "DOCUMENTED"7869 ],7870 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7871 "variant": "search",7872 "schema_ref": "WebSearchActionSearch"7873 },7874 {7875 "provider": "openai",7876 "endpoint": "POST /v1/conversations/{conversation_id}/items",7877 "parameter": "items[](web_search_call).action(open_page)",7878 "location": "body",7879 "type": "object",7880 "required": true,7881 "default": null,7882 "minimum": null,7883 "maximum": null,7884 "enum": null,7885 "description": "Action type \"open_page\" - Opens a specific URL from search results.",7886 "compatible_models": [7887 "*"7888 ],7889 "beta_header": null,7890 "status": [7891 "DOCUMENTED"7892 ],7893 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7894 "variant": "open_page",7895 "schema_ref": "WebSearchActionOpenPage"7896 },7897 {7898 "provider": "openai",7899 "endpoint": "POST /v1/conversations/{conversation_id}/items",7900 "parameter": "items[](web_search_call).action(find_in_page)",7901 "location": "body",7902 "type": "object",7903 "required": true,7904 "default": null,7905 "minimum": null,7906 "maximum": null,7907 "enum": null,7908 "description": "Action type \"find_in_page\": Searches for a pattern within a loaded page.",7909 "compatible_models": [7910 "*"7911 ],7912 "beta_header": null,7913 "status": [7914 "DOCUMENTED"7915 ],7916 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7917 "variant": "find_in_page",7918 "schema_ref": "WebSearchActionFind"7919 },7920 {7921 "provider": "openai",7922 "endpoint": "POST /v1/conversations/{conversation_id}/items",7923 "parameter": "items[](function_call)",7924 "location": "body",7925 "type": "object",7926 "required": false,7927 "default": null,7928 "minimum": null,7929 "maximum": null,7930 "enum": null,7931 "description": "A tool call to run a function. See the [function calling guide](https://developers.openai.com/api/docs/guides/function-calling) for more information.",7932 "compatible_models": [7933 "*"7934 ],7935 "beta_header": null,7936 "status": [7937 "DOCUMENTED"7938 ],7939 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",7940 "variant": "function_call",7941 "schema_ref": "FunctionToolCall"7942 },7943 {7944 "provider": "openai",7945 "endpoint": "POST /v1/conversations/{conversation_id}/items",7946 "parameter": "items[](function_call).id",7947 "location": "body",7948 "type": "string",7949 "required": false,7950 "default": null,7951 "minimum": null,7952 "maximum": null,7953 "enum": null,7954 "description": "The unique ID of the function tool call.",7955 "compatible_models": [7956 "*"7957 ],7958 "beta_header": null,7959 "status": [7960 "DOCUMENTED"7961 ],7962 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7963 },7964 {7965 "provider": "openai",7966 "endpoint": "POST /v1/conversations/{conversation_id}/items",7967 "parameter": "items[](function_call).type",7968 "location": "body",7969 "type": "string",7970 "required": true,7971 "default": null,7972 "minimum": null,7973 "maximum": null,7974 "enum": [7975 "function_call"7976 ],7977 "description": "The type of the function tool call. Always `function_call`.",7978 "compatible_models": [7979 "*"7980 ],7981 "beta_header": null,7982 "status": [7983 "DOCUMENTED"7984 ],7985 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"7986 },7987 {7988 "provider": "openai",7989 "endpoint": "POST /v1/conversations/{conversation_id}/items",7990 "parameter": "items[](function_call).call_id",7991 "location": "body",7992 "type": "string",7993 "required": true,7994 "default": null,7995 "minimum": null,7996 "maximum": null,7997 "enum": null,7998 "description": "The unique ID of the function tool call generated by the model.",7999 "compatible_models": [8000 "*"8001 ],8002 "beta_header": null,8003 "status": [8004 "DOCUMENTED"8005 ],8006 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8007 },8008 {8009 "provider": "openai",8010 "endpoint": "POST /v1/conversations/{conversation_id}/items",8011 "parameter": "items[](function_call).caller",8012 "location": "body",8013 "type": "object<direct> | object<program>",8014 "required": false,8015 "default": null,8016 "minimum": null,8017 "maximum": null,8018 "enum": null,8019 "description": "The execution context that produced this tool call.",8020 "compatible_models": [8021 "*"8022 ],8023 "beta_header": null,8024 "status": [8025 "DOCUMENTED"8026 ],8027 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8028 "nullable": true8029 },8030 {8031 "provider": "openai",8032 "endpoint": "POST /v1/conversations/{conversation_id}/items",8033 "parameter": "items[](function_call).caller(direct)",8034 "location": "body",8035 "type": "object",8036 "required": false,8037 "default": null,8038 "minimum": null,8039 "maximum": null,8040 "enum": null,8041 "description": "",8042 "compatible_models": [8043 "*"8044 ],8045 "beta_header": null,8046 "status": [8047 "DOCUMENTED"8048 ],8049 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8050 "variant": "direct",8051 "schema_ref": "DirectToolCallCaller"8052 },8053 {8054 "provider": "openai",8055 "endpoint": "POST /v1/conversations/{conversation_id}/items",8056 "parameter": "items[](function_call).caller(program)",8057 "location": "body",8058 "type": "object",8059 "required": false,8060 "default": null,8061 "minimum": null,8062 "maximum": null,8063 "enum": null,8064 "description": "",8065 "compatible_models": [8066 "*"8067 ],8068 "beta_header": null,8069 "status": [8070 "DOCUMENTED"8071 ],8072 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8073 "variant": "program",8074 "schema_ref": "ProgramToolCallCaller"8075 },8076 {8077 "provider": "openai",8078 "endpoint": "POST /v1/conversations/{conversation_id}/items",8079 "parameter": "items[](function_call).namespace",8080 "location": "body",8081 "type": "string",8082 "required": false,8083 "default": null,8084 "minimum": null,8085 "maximum": null,8086 "enum": null,8087 "description": "The namespace of the function to run.",8088 "compatible_models": [8089 "*"8090 ],8091 "beta_header": null,8092 "status": [8093 "DOCUMENTED"8094 ],8095 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8096 },8097 {8098 "provider": "openai",8099 "endpoint": "POST /v1/conversations/{conversation_id}/items",8100 "parameter": "items[](function_call).name",8101 "location": "body",8102 "type": "string",8103 "required": true,8104 "default": null,8105 "minimum": null,8106 "maximum": null,8107 "enum": null,8108 "description": "The name of the function to run.",8109 "compatible_models": [8110 "*"8111 ],8112 "beta_header": null,8113 "status": [8114 "DOCUMENTED"8115 ],8116 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8117 },8118 {8119 "provider": "openai",8120 "endpoint": "POST /v1/conversations/{conversation_id}/items",8121 "parameter": "items[](function_call).arguments",8122 "location": "body",8123 "type": "string",8124 "required": true,8125 "default": null,8126 "minimum": null,8127 "maximum": null,8128 "enum": null,8129 "description": "A JSON string of the arguments to pass to the function.",8130 "compatible_models": [8131 "*"8132 ],8133 "beta_header": null,8134 "status": [8135 "DOCUMENTED"8136 ],8137 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8138 },8139 {8140 "provider": "openai",8141 "endpoint": "POST /v1/conversations/{conversation_id}/items",8142 "parameter": "items[](function_call).status",8143 "location": "body",8144 "type": "string",8145 "required": false,8146 "default": null,8147 "minimum": null,8148 "maximum": null,8149 "enum": [8150 "in_progress",8151 "completed",8152 "incomplete"8153 ],8154 "description": "The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.",8155 "compatible_models": [8156 "*"8157 ],8158 "beta_header": null,8159 "status": [8160 "DOCUMENTED"8161 ],8162 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8163 },8164 {8165 "provider": "openai",8166 "endpoint": "POST /v1/conversations/{conversation_id}/items",8167 "parameter": "items[](function_call).async",8168 "location": "body",8169 "type": "boolean",8170 "required": false,8171 "default": null,8172 "minimum": null,8173 "maximum": null,8174 "enum": null,8175 "description": "Whether the function tool call runs asynchronously.",8176 "compatible_models": [8177 "*"8178 ],8179 "beta_header": null,8180 "status": [8181 "DOCUMENTED"8182 ],8183 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8184 },8185 {8186 "provider": "openai",8187 "endpoint": "POST /v1/conversations/{conversation_id}/items",8188 "parameter": "items[](function_call_output)",8189 "location": "body",8190 "type": "object",8191 "required": false,8192 "default": null,8193 "minimum": null,8194 "maximum": null,8195 "enum": null,8196 "description": "The output of a function tool call.",8197 "compatible_models": [8198 "*"8199 ],8200 "beta_header": null,8201 "status": [8202 "DOCUMENTED"8203 ],8204 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8205 "variant": "function_call_output",8206 "schema_ref": "FunctionCallOutputItemParam"8207 },8208 {8209 "provider": "openai",8210 "endpoint": "POST /v1/conversations/{conversation_id}/items",8211 "parameter": "items[](function_call_output).id",8212 "location": "body",8213 "type": "string | null",8214 "required": false,8215 "default": null,8216 "minimum": null,8217 "maximum": null,8218 "enum": null,8219 "description": "The unique ID of the function tool call output. Populated when this item is returned via API.",8220 "compatible_models": [8221 "*"8222 ],8223 "beta_header": null,8224 "status": [8225 "DOCUMENTED"8226 ],8227 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8228 "nullable": true8229 },8230 {8231 "provider": "openai",8232 "endpoint": "POST /v1/conversations/{conversation_id}/items",8233 "parameter": "items[](function_call_output).call_id",8234 "location": "body",8235 "type": "string | null",8236 "required": false,8237 "default": null,8238 "minimum": null,8239 "maximum": null,8240 "enum": null,8241 "description": "The unique ID of the function tool call generated by the model.",8242 "compatible_models": [8243 "*"8244 ],8245 "beta_header": null,8246 "status": [8247 "DOCUMENTED"8248 ],8249 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8250 "nullable": true8251 },8252 {8253 "provider": "openai",8254 "endpoint": "POST /v1/conversations/{conversation_id}/items",8255 "parameter": "items[](function_call_output).type",8256 "location": "body",8257 "type": "string",8258 "required": true,8259 "default": "function_call_output",8260 "minimum": null,8261 "maximum": null,8262 "enum": [8263 "function_call_output"8264 ],8265 "description": "The type of the function tool call output. Always `function_call_output`.",8266 "compatible_models": [8267 "*"8268 ],8269 "beta_header": null,8270 "status": [8271 "DOCUMENTED"8272 ],8273 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8274 },8275 {8276 "provider": "openai",8277 "endpoint": "POST /v1/conversations/{conversation_id}/items",8278 "parameter": "items[](function_call_output).output",8279 "location": "body",8280 "type": "string | array<object<input_text> | object<input_image> | object<input_file>>",8281 "required": true,8282 "default": null,8283 "minimum": null,8284 "maximum": null,8285 "enum": null,8286 "description": "Text, image, or file output of the function tool call.",8287 "compatible_models": [8288 "*"8289 ],8290 "beta_header": null,8291 "status": [8292 "DOCUMENTED"8293 ],8294 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8295 },8296 {8297 "provider": "openai",8298 "endpoint": "POST /v1/conversations/{conversation_id}/items",8299 "parameter": "items[](function_call_output).output[]",8300 "location": "body",8301 "type": "array<object<input_text> | object<input_image> | object<input_file>>",8302 "required": false,8303 "default": null,8304 "minimum": null,8305 "maximum": null,8306 "enum": null,8307 "description": "An array of content outputs (text, image, file) for the function tool call.",8308 "compatible_models": [8309 "*"8310 ],8311 "beta_header": null,8312 "status": [8313 "DOCUMENTED"8314 ],8315 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8316 },8317 {8318 "provider": "openai",8319 "endpoint": "POST /v1/conversations/{conversation_id}/items",8320 "parameter": "items[](function_call_output).name",8321 "location": "body",8322 "type": "string | null",8323 "required": false,8324 "default": null,8325 "minimum": null,8326 "maximum": null,8327 "enum": null,8328 "description": "The name of the tool that produced the output.",8329 "compatible_models": [8330 "*"8331 ],8332 "beta_header": null,8333 "status": [8334 "DOCUMENTED"8335 ],8336 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8337 "nullable": true8338 },8339 {8340 "provider": "openai",8341 "endpoint": "POST /v1/conversations/{conversation_id}/items",8342 "parameter": "items[](function_call_output).namespace",8343 "location": "body",8344 "type": "string | null",8345 "required": false,8346 "default": null,8347 "minimum": null,8348 "maximum": null,8349 "enum": null,8350 "description": "The namespace of the tool that produced the output.",8351 "compatible_models": [8352 "*"8353 ],8354 "beta_header": null,8355 "status": [8356 "DOCUMENTED"8357 ],8358 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8359 "nullable": true8360 },8361 {8362 "provider": "openai",8363 "endpoint": "POST /v1/conversations/{conversation_id}/items",8364 "parameter": "items[](function_call_output).caller",8365 "location": "body",8366 "type": "object<direct> | object<program>",8367 "required": false,8368 "default": null,8369 "minimum": null,8370 "maximum": null,8371 "enum": null,8372 "description": "The execution context that produced this tool call.",8373 "compatible_models": [8374 "*"8375 ],8376 "beta_header": null,8377 "status": [8378 "DOCUMENTED"8379 ],8380 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8381 "nullable": true8382 },8383 {8384 "provider": "openai",8385 "endpoint": "POST /v1/conversations/{conversation_id}/items",8386 "parameter": "items[](function_call_output).caller(direct)",8387 "location": "body",8388 "type": "object",8389 "required": false,8390 "default": null,8391 "minimum": null,8392 "maximum": null,8393 "enum": null,8394 "description": "",8395 "compatible_models": [8396 "*"8397 ],8398 "beta_header": null,8399 "status": [8400 "DOCUMENTED"8401 ],8402 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8403 "variant": "direct",8404 "schema_ref": "DirectToolCallCallerParam"8405 },8406 {8407 "provider": "openai",8408 "endpoint": "POST /v1/conversations/{conversation_id}/items",8409 "parameter": "items[](function_call_output).caller(program)",8410 "location": "body",8411 "type": "object",8412 "required": false,8413 "default": null,8414 "minimum": null,8415 "maximum": null,8416 "enum": null,8417 "description": "",8418 "compatible_models": [8419 "*"8420 ],8421 "beta_header": null,8422 "status": [8423 "DOCUMENTED"8424 ],8425 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8426 "variant": "program",8427 "schema_ref": "ProgramToolCallCallerParam"8428 },8429 {8430 "provider": "openai",8431 "endpoint": "POST /v1/conversations/{conversation_id}/items",8432 "parameter": "items[](function_call_output).status",8433 "location": "body",8434 "type": "string | null",8435 "required": false,8436 "default": null,8437 "minimum": null,8438 "maximum": null,8439 "enum": [8440 "in_progress",8441 "completed",8442 "incomplete"8443 ],8444 "description": "The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.",8445 "compatible_models": [8446 "*"8447 ],8448 "beta_header": null,8449 "status": [8450 "DOCUMENTED"8451 ],8452 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8453 "nullable": true8454 },8455 {8456 "provider": "openai",8457 "endpoint": "POST /v1/conversations/{conversation_id}/items",8458 "parameter": "items[](tool_search_call)",8459 "location": "body",8460 "type": "object",8461 "required": false,8462 "default": null,8463 "minimum": null,8464 "maximum": null,8465 "enum": null,8466 "description": "",8467 "compatible_models": [8468 "*"8469 ],8470 "beta_header": null,8471 "status": [8472 "DOCUMENTED"8473 ],8474 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8475 "variant": "tool_search_call",8476 "schema_ref": "ToolSearchCallItemParam"8477 },8478 {8479 "provider": "openai",8480 "endpoint": "POST /v1/conversations/{conversation_id}/items",8481 "parameter": "items[](tool_search_call).id",8482 "location": "body",8483 "type": "string | null",8484 "required": false,8485 "default": null,8486 "minimum": null,8487 "maximum": null,8488 "enum": null,8489 "description": "The unique ID of this tool search call.",8490 "compatible_models": [8491 "*"8492 ],8493 "beta_header": null,8494 "status": [8495 "DOCUMENTED"8496 ],8497 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8498 "nullable": true8499 },8500 {8501 "provider": "openai",8502 "endpoint": "POST /v1/conversations/{conversation_id}/items",8503 "parameter": "items[](tool_search_call).call_id",8504 "location": "body",8505 "type": "string | null",8506 "required": false,8507 "default": null,8508 "minimum": null,8509 "maximum": null,8510 "enum": null,8511 "description": "The unique ID of the tool search call generated by the model.",8512 "compatible_models": [8513 "*"8514 ],8515 "beta_header": null,8516 "status": [8517 "DOCUMENTED"8518 ],8519 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8520 "nullable": true8521 },8522 {8523 "provider": "openai",8524 "endpoint": "POST /v1/conversations/{conversation_id}/items",8525 "parameter": "items[](tool_search_call).type",8526 "location": "body",8527 "type": "string",8528 "required": true,8529 "default": "tool_search_call",8530 "minimum": null,8531 "maximum": null,8532 "enum": [8533 "tool_search_call"8534 ],8535 "description": "The item type. Always `tool_search_call`.",8536 "compatible_models": [8537 "*"8538 ],8539 "beta_header": null,8540 "status": [8541 "DOCUMENTED"8542 ],8543 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8544 },8545 {8546 "provider": "openai",8547 "endpoint": "POST /v1/conversations/{conversation_id}/items",8548 "parameter": "items[](tool_search_call).execution",8549 "location": "body",8550 "type": "string",8551 "required": false,8552 "default": null,8553 "minimum": null,8554 "maximum": null,8555 "enum": [8556 "server",8557 "client"8558 ],8559 "description": "Whether tool search was executed by the server or by the client.",8560 "compatible_models": [8561 "*"8562 ],8563 "beta_header": null,8564 "status": [8565 "DOCUMENTED"8566 ],8567 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8568 "schema_ref": "ToolSearchExecutionType"8569 },8570 {8571 "provider": "openai",8572 "endpoint": "POST /v1/conversations/{conversation_id}/items",8573 "parameter": "items[](tool_search_call).arguments",8574 "location": "body",8575 "type": "object",8576 "required": true,8577 "default": null,8578 "minimum": null,8579 "maximum": null,8580 "enum": null,8581 "description": "The arguments supplied to the tool search call.",8582 "compatible_models": [8583 "*"8584 ],8585 "beta_header": null,8586 "status": [8587 "DOCUMENTED"8588 ],8589 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8590 "schema_ref": "EmptyModelParam"8591 },8592 {8593 "provider": "openai",8594 "endpoint": "POST /v1/conversations/{conversation_id}/items",8595 "parameter": "items[](tool_search_call).status",8596 "location": "body",8597 "type": "string | null",8598 "required": false,8599 "default": null,8600 "minimum": null,8601 "maximum": null,8602 "enum": [8603 "in_progress",8604 "completed",8605 "incomplete"8606 ],8607 "description": "The status of the tool search call.",8608 "compatible_models": [8609 "*"8610 ],8611 "beta_header": null,8612 "status": [8613 "DOCUMENTED"8614 ],8615 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8616 "nullable": true8617 },8618 {8619 "provider": "openai",8620 "endpoint": "POST /v1/conversations/{conversation_id}/items",8621 "parameter": "items[](tool_search_output)",8622 "location": "body",8623 "type": "object",8624 "required": false,8625 "default": null,8626 "minimum": null,8627 "maximum": null,8628 "enum": null,8629 "description": "",8630 "compatible_models": [8631 "*"8632 ],8633 "beta_header": null,8634 "status": [8635 "DOCUMENTED"8636 ],8637 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8638 "variant": "tool_search_output",8639 "schema_ref": "ToolSearchOutputItemParam"8640 },8641 {8642 "provider": "openai",8643 "endpoint": "POST /v1/conversations/{conversation_id}/items",8644 "parameter": "items[](tool_search_output).id",8645 "location": "body",8646 "type": "string | null",8647 "required": false,8648 "default": null,8649 "minimum": null,8650 "maximum": null,8651 "enum": null,8652 "description": "The unique ID of this tool search output.",8653 "compatible_models": [8654 "*"8655 ],8656 "beta_header": null,8657 "status": [8658 "DOCUMENTED"8659 ],8660 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8661 "nullable": true8662 },8663 {8664 "provider": "openai",8665 "endpoint": "POST /v1/conversations/{conversation_id}/items",8666 "parameter": "items[](tool_search_output).call_id",8667 "location": "body",8668 "type": "string | null",8669 "required": false,8670 "default": null,8671 "minimum": null,8672 "maximum": null,8673 "enum": null,8674 "description": "The unique ID of the tool search call generated by the model.",8675 "compatible_models": [8676 "*"8677 ],8678 "beta_header": null,8679 "status": [8680 "DOCUMENTED"8681 ],8682 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8683 "nullable": true8684 },8685 {8686 "provider": "openai",8687 "endpoint": "POST /v1/conversations/{conversation_id}/items",8688 "parameter": "items[](tool_search_output).type",8689 "location": "body",8690 "type": "string",8691 "required": true,8692 "default": "tool_search_output",8693 "minimum": null,8694 "maximum": null,8695 "enum": [8696 "tool_search_output"8697 ],8698 "description": "The item type. Always `tool_search_output`.",8699 "compatible_models": [8700 "*"8701 ],8702 "beta_header": null,8703 "status": [8704 "DOCUMENTED"8705 ],8706 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8707 },8708 {8709 "provider": "openai",8710 "endpoint": "POST /v1/conversations/{conversation_id}/items",8711 "parameter": "items[](tool_search_output).execution",8712 "location": "body",8713 "type": "string",8714 "required": false,8715 "default": null,8716 "minimum": null,8717 "maximum": null,8718 "enum": [8719 "server",8720 "client"8721 ],8722 "description": "Whether tool search was executed by the server or by the client.",8723 "compatible_models": [8724 "*"8725 ],8726 "beta_header": null,8727 "status": [8728 "DOCUMENTED"8729 ],8730 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8731 "schema_ref": "ToolSearchExecutionType"8732 },8733 {8734 "provider": "openai",8735 "endpoint": "POST /v1/conversations/{conversation_id}/items",8736 "parameter": "items[](tool_search_output).tools",8737 "location": "body",8738 "type": "array<object<function> | object<file_search> | object<computer> | object<computer_use_preview> | WebSearchTool | object<mcp> | object<code_interpreter> | object<programmatic_tool_calling> | object<image_generation> | object<local_shell> | object<shell> | object<custom> | object<namespace> | object<tool_search> | WebSearchPreviewTool | object<apply_patch>>",8739 "required": true,8740 "default": null,8741 "minimum": null,8742 "maximum": null,8743 "enum": null,8744 "description": "The loaded tool definitions returned by the tool search output.",8745 "compatible_models": [8746 "*"8747 ],8748 "beta_header": null,8749 "status": [8750 "DOCUMENTED"8751 ],8752 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8753 },8754 {8755 "provider": "openai",8756 "endpoint": "POST /v1/conversations/{conversation_id}/items",8757 "parameter": "items[](tool_search_output).tools[]",8758 "location": "body",8759 "type": "object<function> | object<file_search> | object<computer> | object<computer_use_preview> | WebSearchTool | object<mcp> | object<code_interpreter> | object<programmatic_tool_calling> | object<image_generation> | object<local_shell> | object<shell> | object<custom> | object<namespace> | object<tool_search> | WebSearchPreviewTool | object<apply_patch>",8760 "required": false,8761 "default": null,8762 "minimum": null,8763 "maximum": null,8764 "enum": null,8765 "description": "A tool that can be used to generate a response.",8766 "compatible_models": [8767 "*"8768 ],8769 "beta_header": null,8770 "status": [8771 "DOCUMENTED"8772 ],8773 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8774 "schema_ref": "Tool"8775 },8776 {8777 "provider": "openai",8778 "endpoint": "POST /v1/conversations/{conversation_id}/items",8779 "parameter": "items[](tool_search_output).status",8780 "location": "body",8781 "type": "string | null",8782 "required": false,8783 "default": null,8784 "minimum": null,8785 "maximum": null,8786 "enum": [8787 "in_progress",8788 "completed",8789 "incomplete"8790 ],8791 "description": "The status of the tool search output.",8792 "compatible_models": [8793 "*"8794 ],8795 "beta_header": null,8796 "status": [8797 "DOCUMENTED"8798 ],8799 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8800 "nullable": true8801 },8802 {8803 "provider": "openai",8804 "endpoint": "POST /v1/conversations/{conversation_id}/items",8805 "parameter": "items[](additional_tools)",8806 "location": "body",8807 "type": "object",8808 "required": false,8809 "default": null,8810 "minimum": null,8811 "maximum": null,8812 "enum": null,8813 "description": "",8814 "compatible_models": [8815 "*"8816 ],8817 "beta_header": null,8818 "status": [8819 "DOCUMENTED"8820 ],8821 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8822 "variant": "additional_tools",8823 "schema_ref": "AdditionalToolsItemParam"8824 },8825 {8826 "provider": "openai",8827 "endpoint": "POST /v1/conversations/{conversation_id}/items",8828 "parameter": "items[](additional_tools).id",8829 "location": "body",8830 "type": "string | null",8831 "required": false,8832 "default": null,8833 "minimum": null,8834 "maximum": null,8835 "enum": null,8836 "description": "The unique ID of this additional tools item.",8837 "compatible_models": [8838 "*"8839 ],8840 "beta_header": null,8841 "status": [8842 "DOCUMENTED"8843 ],8844 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8845 "nullable": true8846 },8847 {8848 "provider": "openai",8849 "endpoint": "POST /v1/conversations/{conversation_id}/items",8850 "parameter": "items[](additional_tools).type",8851 "location": "body",8852 "type": "string",8853 "required": true,8854 "default": "additional_tools",8855 "minimum": null,8856 "maximum": null,8857 "enum": [8858 "additional_tools"8859 ],8860 "description": "The item type. Always `additional_tools`.",8861 "compatible_models": [8862 "*"8863 ],8864 "beta_header": null,8865 "status": [8866 "DOCUMENTED"8867 ],8868 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8869 },8870 {8871 "provider": "openai",8872 "endpoint": "POST /v1/conversations/{conversation_id}/items",8873 "parameter": "items[](additional_tools).role",8874 "location": "body",8875 "type": "string",8876 "required": true,8877 "default": "developer",8878 "minimum": null,8879 "maximum": null,8880 "enum": [8881 "developer"8882 ],8883 "description": "The role that provided the additional tools. Only `developer` is supported.",8884 "compatible_models": [8885 "*"8886 ],8887 "beta_header": null,8888 "status": [8889 "DOCUMENTED"8890 ],8891 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8892 },8893 {8894 "provider": "openai",8895 "endpoint": "POST /v1/conversations/{conversation_id}/items",8896 "parameter": "items[](additional_tools).tools",8897 "location": "body",8898 "type": "array<object<function> | object<file_search> | object<computer> | object<computer_use_preview> | WebSearchTool | object<mcp> | object<code_interpreter> | object<programmatic_tool_calling> | object<image_generation> | object<local_shell> | object<shell> | object<custom> | object<namespace> | object<tool_search> | WebSearchPreviewTool | object<apply_patch>>",8899 "required": true,8900 "default": null,8901 "minimum": null,8902 "maximum": null,8903 "enum": null,8904 "description": "A list of additional tools made available at this item.",8905 "compatible_models": [8906 "*"8907 ],8908 "beta_header": null,8909 "status": [8910 "DOCUMENTED"8911 ],8912 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"8913 },8914 {8915 "provider": "openai",8916 "endpoint": "POST /v1/conversations/{conversation_id}/items",8917 "parameter": "items[](additional_tools).tools[]",8918 "location": "body",8919 "type": "object<function> | object<file_search> | object<computer> | object<computer_use_preview> | WebSearchTool | object<mcp> | object<code_interpreter> | object<programmatic_tool_calling> | object<image_generation> | object<local_shell> | object<shell> | object<custom> | object<namespace> | object<tool_search> | WebSearchPreviewTool | object<apply_patch>",8920 "required": false,8921 "default": null,8922 "minimum": null,8923 "maximum": null,8924 "enum": null,8925 "description": "A tool that can be used to generate a response.",8926 "compatible_models": [8927 "*"8928 ],8929 "beta_header": null,8930 "status": [8931 "DOCUMENTED"8932 ],8933 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8934 "schema_ref": "Tool"8935 },8936 {8937 "provider": "openai",8938 "endpoint": "POST /v1/conversations/{conversation_id}/items",8939 "parameter": "items[](configuration_update)",8940 "location": "body",8941 "type": "object",8942 "required": false,8943 "default": null,8944 "minimum": null,8945 "maximum": null,8946 "enum": null,8947 "description": "An update to the conversation's response configuration. The configuration remains in effect for subsequent responses until it is replaced by another configuration update.",8948 "compatible_models": [8949 "*"8950 ],8951 "beta_header": null,8952 "status": [8953 "DOCUMENTED"8954 ],8955 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8956 "variant": "configuration_update",8957 "schema_ref": "ResponseConfigurationUpdateItemParam"8958 },8959 {8960 "provider": "openai",8961 "endpoint": "POST /v1/conversations/{conversation_id}/items",8962 "parameter": "items[](configuration_update).id",8963 "location": "body",8964 "type": "string | null",8965 "required": false,8966 "default": null,8967 "minimum": null,8968 "maximum": null,8969 "enum": null,8970 "description": "The unique ID of the configuration update item.",8971 "compatible_models": [8972 "*"8973 ],8974 "beta_header": null,8975 "status": [8976 "DOCUMENTED"8977 ],8978 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",8979 "nullable": true8980 },8981 {8982 "provider": "openai",8983 "endpoint": "POST /v1/conversations/{conversation_id}/items",8984 "parameter": "items[](configuration_update).type",8985 "location": "body",8986 "type": "string",8987 "required": true,8988 "default": "configuration_update",8989 "minimum": null,8990 "maximum": null,8991 "enum": [8992 "configuration_update"8993 ],8994 "description": "The item type. Always `configuration_update`.",8995 "compatible_models": [8996 "*"8997 ],8998 "beta_header": null,8999 "status": [9000 "DOCUMENTED"9001 ],9002 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9003 },9004 {9005 "provider": "openai",9006 "endpoint": "POST /v1/conversations/{conversation_id}/items",9007 "parameter": "items[](configuration_update).reasoning",9008 "location": "body",9009 "type": "object",9010 "required": false,9011 "default": null,9012 "minimum": null,9013 "maximum": null,9014 "enum": null,9015 "description": "Updates to reasoning configuration. Only effort is supported.",9016 "compatible_models": [9017 "*"9018 ],9019 "beta_header": null,9020 "status": [9021 "DOCUMENTED"9022 ],9023 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9024 },9025 {9026 "provider": "openai",9027 "endpoint": "POST /v1/conversations/{conversation_id}/items",9028 "parameter": "items[](configuration_update).reasoning.effort",9029 "location": "body",9030 "type": "string | null",9031 "required": false,9032 "default": "medium",9033 "minimum": null,9034 "maximum": null,9035 "enum": [9036 "none",9037 "minimal",9038 "low",9039 "medium",9040 "high",9041 "xhigh",9042 "max"9043 ],9044 "description": "The reasoning effort to use for subsequent responses until another configuration update replaces it.",9045 "compatible_models": [9046 "*"9047 ],9048 "beta_header": null,9049 "status": [9050 "DOCUMENTED"9051 ],9052 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9053 "nullable": true,9054 "schema_ref": "ReasoningEffort"9055 },9056 {9057 "provider": "openai",9058 "endpoint": "POST /v1/conversations/{conversation_id}/items",9059 "parameter": "items[](reasoning)",9060 "location": "body",9061 "type": "object",9062 "required": false,9063 "default": null,9064 "minimum": null,9065 "maximum": null,9066 "enum": null,9067 "description": "A description of the chain of thought used by a reasoning model while generating a response. Be sure to include these items in your `input` to the Responses API for subsequent turns of a conversation if you are manually [managing context](https://developers.openai.com/api/docs/guides/conversation-state).",9068 "compatible_models": [9069 "*"9070 ],9071 "beta_header": null,9072 "status": [9073 "DOCUMENTED"9074 ],9075 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9076 "variant": "reasoning",9077 "schema_ref": "ReasoningItem"9078 },9079 {9080 "provider": "openai",9081 "endpoint": "POST /v1/conversations/{conversation_id}/items",9082 "parameter": "items[](reasoning).type",9083 "location": "body",9084 "type": "string",9085 "required": true,9086 "default": null,9087 "minimum": null,9088 "maximum": null,9089 "enum": [9090 "reasoning"9091 ],9092 "description": "The type of the object. Always `reasoning`.",9093 "compatible_models": [9094 "*"9095 ],9096 "beta_header": null,9097 "status": [9098 "DOCUMENTED"9099 ],9100 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9101 },9102 {9103 "provider": "openai",9104 "endpoint": "POST /v1/conversations/{conversation_id}/items",9105 "parameter": "items[](reasoning).id",9106 "location": "body",9107 "type": "string",9108 "required": true,9109 "default": null,9110 "minimum": null,9111 "maximum": null,9112 "enum": null,9113 "description": "The unique identifier of the reasoning content.",9114 "compatible_models": [9115 "*"9116 ],9117 "beta_header": null,9118 "status": [9119 "DOCUMENTED"9120 ],9121 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9122 },9123 {9124 "provider": "openai",9125 "endpoint": "POST /v1/conversations/{conversation_id}/items",9126 "parameter": "items[](reasoning).encrypted_content",9127 "location": "body",9128 "type": "string | null",9129 "required": false,9130 "default": null,9131 "minimum": null,9132 "maximum": null,9133 "enum": null,9134 "description": "The encrypted content of the reasoning item. This is populated by default for reasoning items returned by `POST /v1/responses` and WebSocket `response.create` requests. When streaming, use the completed reasoning item and its `encrypted_content` from the `response.output_item.done` event in subsequent requests. The `encrypted_content` in `response.output_item.added` may be incomplete. This is especially important when `store` is `false` or when using Zero Data Retention.",9135 "compatible_models": [9136 "*"9137 ],9138 "beta_header": null,9139 "status": [9140 "DOCUMENTED"9141 ],9142 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9143 "nullable": true9144 },9145 {9146 "provider": "openai",9147 "endpoint": "POST /v1/conversations/{conversation_id}/items",9148 "parameter": "items[](reasoning).summary",9149 "location": "body",9150 "type": "array<object>",9151 "required": true,9152 "default": null,9153 "minimum": null,9154 "maximum": null,9155 "enum": null,9156 "description": "Reasoning summary content.",9157 "compatible_models": [9158 "*"9159 ],9160 "beta_header": null,9161 "status": [9162 "DOCUMENTED"9163 ],9164 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9165 },9166 {9167 "provider": "openai",9168 "endpoint": "POST /v1/conversations/{conversation_id}/items",9169 "parameter": "items[](reasoning).summary[]",9170 "location": "body",9171 "type": "object",9172 "required": false,9173 "default": null,9174 "minimum": null,9175 "maximum": null,9176 "enum": null,9177 "description": "A summary text from the model.",9178 "compatible_models": [9179 "*"9180 ],9181 "beta_header": null,9182 "status": [9183 "DOCUMENTED"9184 ],9185 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9186 "schema_ref": "SummaryTextContent"9187 },9188 {9189 "provider": "openai",9190 "endpoint": "POST /v1/conversations/{conversation_id}/items",9191 "parameter": "items[](reasoning).content",9192 "location": "body",9193 "type": "array<object>",9194 "required": false,9195 "default": null,9196 "minimum": null,9197 "maximum": null,9198 "enum": null,9199 "description": "Reasoning text content.",9200 "compatible_models": [9201 "*"9202 ],9203 "beta_header": null,9204 "status": [9205 "DOCUMENTED"9206 ],9207 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9208 },9209 {9210 "provider": "openai",9211 "endpoint": "POST /v1/conversations/{conversation_id}/items",9212 "parameter": "items[](reasoning).content[]",9213 "location": "body",9214 "type": "object",9215 "required": false,9216 "default": null,9217 "minimum": null,9218 "maximum": null,9219 "enum": null,9220 "description": "Reasoning text from the model.",9221 "compatible_models": [9222 "*"9223 ],9224 "beta_header": null,9225 "status": [9226 "DOCUMENTED"9227 ],9228 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9229 "schema_ref": "ReasoningTextContent"9230 },9231 {9232 "provider": "openai",9233 "endpoint": "POST /v1/conversations/{conversation_id}/items",9234 "parameter": "items[](reasoning).status",9235 "location": "body",9236 "type": "string",9237 "required": false,9238 "default": null,9239 "minimum": null,9240 "maximum": null,9241 "enum": [9242 "in_progress",9243 "completed",9244 "incomplete"9245 ],9246 "description": "The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when items are returned via API.",9247 "compatible_models": [9248 "*"9249 ],9250 "beta_header": null,9251 "status": [9252 "DOCUMENTED"9253 ],9254 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9255 },9256 {9257 "provider": "openai",9258 "endpoint": "POST /v1/conversations/{conversation_id}/items",9259 "parameter": "items[](compaction)",9260 "location": "body",9261 "type": "object",9262 "required": false,9263 "default": null,9264 "minimum": null,9265 "maximum": null,9266 "enum": null,9267 "description": "A compaction item generated by the [`v1/responses/compact` API](https://developers.openai.com/api/reference/resources/responses/methods/compact).",9268 "compatible_models": [9269 "*"9270 ],9271 "beta_header": null,9272 "status": [9273 "DOCUMENTED"9274 ],9275 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9276 "variant": "compaction",9277 "schema_ref": "CompactionSummaryItemParam"9278 },9279 {9280 "provider": "openai",9281 "endpoint": "POST /v1/conversations/{conversation_id}/items",9282 "parameter": "items[](compaction).id",9283 "location": "body",9284 "type": "string | null",9285 "required": false,9286 "default": null,9287 "minimum": null,9288 "maximum": null,9289 "enum": null,9290 "description": "The ID of the compaction item.",9291 "compatible_models": [9292 "*"9293 ],9294 "beta_header": null,9295 "status": [9296 "DOCUMENTED"9297 ],9298 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9299 "nullable": true9300 },9301 {9302 "provider": "openai",9303 "endpoint": "POST /v1/conversations/{conversation_id}/items",9304 "parameter": "items[](compaction).type",9305 "location": "body",9306 "type": "string",9307 "required": true,9308 "default": "compaction",9309 "minimum": null,9310 "maximum": null,9311 "enum": [9312 "compaction"9313 ],9314 "description": "The type of the item. Always `compaction`.",9315 "compatible_models": [9316 "*"9317 ],9318 "beta_header": null,9319 "status": [9320 "DOCUMENTED"9321 ],9322 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9323 },9324 {9325 "provider": "openai",9326 "endpoint": "POST /v1/conversations/{conversation_id}/items",9327 "parameter": "items[](compaction).encrypted_content",9328 "location": "body",9329 "type": "string",9330 "required": true,9331 "default": null,9332 "minimum": null,9333 "maximum": null,9334 "enum": null,9335 "description": "The encrypted content of the compaction summary.",9336 "compatible_models": [9337 "*"9338 ],9339 "beta_header": null,9340 "status": [9341 "DOCUMENTED"9342 ],9343 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9344 },9345 {9346 "provider": "openai",9347 "endpoint": "POST /v1/conversations/{conversation_id}/items",9348 "parameter": "items[](image_generation_call)",9349 "location": "body",9350 "type": "object",9351 "required": false,9352 "default": null,9353 "minimum": null,9354 "maximum": null,9355 "enum": null,9356 "description": "An image generation request made by the model.",9357 "compatible_models": [9358 "*"9359 ],9360 "beta_header": null,9361 "status": [9362 "DOCUMENTED"9363 ],9364 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9365 "variant": "image_generation_call",9366 "schema_ref": "ImageGenToolCall"9367 },9368 {9369 "provider": "openai",9370 "endpoint": "POST /v1/conversations/{conversation_id}/items",9371 "parameter": "items[](image_generation_call).type",9372 "location": "body",9373 "type": "string",9374 "required": true,9375 "default": null,9376 "minimum": null,9377 "maximum": null,9378 "enum": [9379 "image_generation_call"9380 ],9381 "description": "The type of the image generation call. Always `image_generation_call`.",9382 "compatible_models": [9383 "*"9384 ],9385 "beta_header": null,9386 "status": [9387 "DOCUMENTED"9388 ],9389 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9390 },9391 {9392 "provider": "openai",9393 "endpoint": "POST /v1/conversations/{conversation_id}/items",9394 "parameter": "items[](image_generation_call).id",9395 "location": "body",9396 "type": "string",9397 "required": true,9398 "default": null,9399 "minimum": null,9400 "maximum": null,9401 "enum": null,9402 "description": "The unique ID of the image generation call.",9403 "compatible_models": [9404 "*"9405 ],9406 "beta_header": null,9407 "status": [9408 "DOCUMENTED"9409 ],9410 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9411 },9412 {9413 "provider": "openai",9414 "endpoint": "POST /v1/conversations/{conversation_id}/items",9415 "parameter": "items[](image_generation_call).status",9416 "location": "body",9417 "type": "string",9418 "required": true,9419 "default": null,9420 "minimum": null,9421 "maximum": null,9422 "enum": [9423 "in_progress",9424 "completed",9425 "generating",9426 "failed"9427 ],9428 "description": "The status of the image generation call.",9429 "compatible_models": [9430 "*"9431 ],9432 "beta_header": null,9433 "status": [9434 "DOCUMENTED"9435 ],9436 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9437 },9438 {9439 "provider": "openai",9440 "endpoint": "POST /v1/conversations/{conversation_id}/items",9441 "parameter": "items[](image_generation_call).result",9442 "location": "body",9443 "type": "string | null",9444 "required": true,9445 "default": null,9446 "minimum": null,9447 "maximum": null,9448 "enum": null,9449 "description": "The generated image encoded in base64.",9450 "compatible_models": [9451 "*"9452 ],9453 "beta_header": null,9454 "status": [9455 "DOCUMENTED"9456 ],9457 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9458 "nullable": true9459 },9460 {9461 "provider": "openai",9462 "endpoint": "POST /v1/conversations/{conversation_id}/items",9463 "parameter": "items[](image_generation_call).size",9464 "location": "body",9465 "type": "string",9466 "required": false,9467 "default": null,9468 "minimum": null,9469 "maximum": null,9470 "enum": null,9471 "description": "The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.",9472 "compatible_models": [9473 "*"9474 ],9475 "beta_header": null,9476 "status": [9477 "DOCUMENTED"9478 ],9479 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9480 "nullable": true9481 },9482 {9483 "provider": "openai",9484 "endpoint": "POST /v1/conversations/{conversation_id}/items",9485 "parameter": "items[](image_generation_call).quality",9486 "location": "body",9487 "type": "string | null",9488 "required": false,9489 "default": null,9490 "minimum": null,9491 "maximum": null,9492 "enum": [9493 "low",9494 "medium",9495 "high",9496 "xhigh",9497 "max",9498 "auto"9499 ],9500 "description": "The quality of the image generated by the image generation tool call. One of `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.",9501 "compatible_models": [9502 "*"9503 ],9504 "beta_header": null,9505 "status": [9506 "DOCUMENTED"9507 ],9508 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9509 "nullable": true9510 },9511 {9512 "provider": "openai",9513 "endpoint": "POST /v1/conversations/{conversation_id}/items",9514 "parameter": "items[](image_generation_call).action",9515 "location": "body",9516 "type": "string | null",9517 "required": false,9518 "default": null,9519 "minimum": null,9520 "maximum": null,9521 "enum": [9522 "generate",9523 "edit",9524 "auto"9525 ],9526 "description": "The action used for image generation.",9527 "compatible_models": [9528 "*"9529 ],9530 "beta_header": null,9531 "status": [9532 "DOCUMENTED"9533 ],9534 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9535 "nullable": true9536 },9537 {9538 "provider": "openai",9539 "endpoint": "POST /v1/conversations/{conversation_id}/items",9540 "parameter": "items[](image_generation_call).background",9541 "location": "body",9542 "type": "string | null",9543 "required": false,9544 "default": null,9545 "minimum": null,9546 "maximum": null,9547 "enum": [9548 "transparent",9549 "opaque",9550 "auto"9551 ],9552 "description": "The background setting used for generation.",9553 "compatible_models": [9554 "*"9555 ],9556 "beta_header": null,9557 "status": [9558 "DOCUMENTED"9559 ],9560 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9561 "nullable": true9562 },9563 {9564 "provider": "openai",9565 "endpoint": "POST /v1/conversations/{conversation_id}/items",9566 "parameter": "items[](image_generation_call).output_format",9567 "location": "body",9568 "type": "string | null",9569 "required": false,9570 "default": null,9571 "minimum": null,9572 "maximum": null,9573 "enum": [9574 "png",9575 "webp",9576 "jpeg"9577 ],9578 "description": "The output format used for generation.",9579 "compatible_models": [9580 "*"9581 ],9582 "beta_header": null,9583 "status": [9584 "DOCUMENTED"9585 ],9586 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9587 "nullable": true9588 },9589 {9590 "provider": "openai",9591 "endpoint": "POST /v1/conversations/{conversation_id}/items",9592 "parameter": "items[](image_generation_call).revised_prompt",9593 "location": "body",9594 "type": "string | null",9595 "required": false,9596 "default": null,9597 "minimum": null,9598 "maximum": null,9599 "enum": null,9600 "description": "The prompt that was used after any model prompt rewriting.",9601 "compatible_models": [9602 "*"9603 ],9604 "beta_header": null,9605 "status": [9606 "DOCUMENTED"9607 ],9608 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9609 "nullable": true9610 },9611 {9612 "provider": "openai",9613 "endpoint": "POST /v1/conversations/{conversation_id}/items",9614 "parameter": "items[](code_interpreter_call)",9615 "location": "body",9616 "type": "object",9617 "required": false,9618 "default": null,9619 "minimum": null,9620 "maximum": null,9621 "enum": null,9622 "description": "A tool call to run code.",9623 "compatible_models": [9624 "*"9625 ],9626 "beta_header": null,9627 "status": [9628 "DOCUMENTED"9629 ],9630 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9631 "variant": "code_interpreter_call",9632 "schema_ref": "CodeInterpreterToolCall"9633 },9634 {9635 "provider": "openai",9636 "endpoint": "POST /v1/conversations/{conversation_id}/items",9637 "parameter": "items[](code_interpreter_call).type",9638 "location": "body",9639 "type": "string",9640 "required": true,9641 "default": "code_interpreter_call",9642 "minimum": null,9643 "maximum": null,9644 "enum": [9645 "code_interpreter_call"9646 ],9647 "description": "The type of the code interpreter tool call. Always `code_interpreter_call`.",9648 "compatible_models": [9649 "*"9650 ],9651 "beta_header": null,9652 "status": [9653 "DOCUMENTED"9654 ],9655 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9656 },9657 {9658 "provider": "openai",9659 "endpoint": "POST /v1/conversations/{conversation_id}/items",9660 "parameter": "items[](code_interpreter_call).id",9661 "location": "body",9662 "type": "string",9663 "required": true,9664 "default": null,9665 "minimum": null,9666 "maximum": null,9667 "enum": null,9668 "description": "The unique ID of the code interpreter tool call.",9669 "compatible_models": [9670 "*"9671 ],9672 "beta_header": null,9673 "status": [9674 "DOCUMENTED"9675 ],9676 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9677 },9678 {9679 "provider": "openai",9680 "endpoint": "POST /v1/conversations/{conversation_id}/items",9681 "parameter": "items[](code_interpreter_call).status",9682 "location": "body",9683 "type": "string",9684 "required": true,9685 "default": null,9686 "minimum": null,9687 "maximum": null,9688 "enum": [9689 "in_progress",9690 "completed",9691 "incomplete",9692 "interpreting",9693 "failed"9694 ],9695 "description": "The status of the code interpreter tool call. Valid values are `in_progress`, `completed`, `incomplete`, `interpreting`, and `failed`.",9696 "compatible_models": [9697 "*"9698 ],9699 "beta_header": null,9700 "status": [9701 "DOCUMENTED"9702 ],9703 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9704 },9705 {9706 "provider": "openai",9707 "endpoint": "POST /v1/conversations/{conversation_id}/items",9708 "parameter": "items[](code_interpreter_call).container_id",9709 "location": "body",9710 "type": "string",9711 "required": true,9712 "default": null,9713 "minimum": null,9714 "maximum": null,9715 "enum": null,9716 "description": "The ID of the container used to run the code.",9717 "compatible_models": [9718 "*"9719 ],9720 "beta_header": null,9721 "status": [9722 "DOCUMENTED"9723 ],9724 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9725 },9726 {9727 "provider": "openai",9728 "endpoint": "POST /v1/conversations/{conversation_id}/items",9729 "parameter": "items[](code_interpreter_call).code",9730 "location": "body",9731 "type": "string | null",9732 "required": true,9733 "default": null,9734 "minimum": null,9735 "maximum": null,9736 "enum": null,9737 "description": "The code to run, or null if not available.",9738 "compatible_models": [9739 "*"9740 ],9741 "beta_header": null,9742 "status": [9743 "DOCUMENTED"9744 ],9745 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9746 "nullable": true9747 },9748 {9749 "provider": "openai",9750 "endpoint": "POST /v1/conversations/{conversation_id}/items",9751 "parameter": "items[](code_interpreter_call).outputs",9752 "location": "body",9753 "type": "array<object<logs> | object<image>>",9754 "required": true,9755 "default": null,9756 "minimum": null,9757 "maximum": null,9758 "enum": null,9759 "description": "The outputs generated by the code interpreter, such as logs or images. Can be null if no outputs are available.",9760 "compatible_models": [9761 "*"9762 ],9763 "beta_header": null,9764 "status": [9765 "DOCUMENTED"9766 ],9767 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9768 "nullable": true9769 },9770 {9771 "provider": "openai",9772 "endpoint": "POST /v1/conversations/{conversation_id}/items",9773 "parameter": "items[](code_interpreter_call).outputs[]",9774 "location": "body",9775 "type": "object<logs> | object<image>",9776 "required": false,9777 "default": null,9778 "minimum": null,9779 "maximum": null,9780 "enum": null,9781 "description": "",9782 "compatible_models": [9783 "*"9784 ],9785 "beta_header": null,9786 "status": [9787 "DOCUMENTED"9788 ],9789 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9790 },9791 {9792 "provider": "openai",9793 "endpoint": "POST /v1/conversations/{conversation_id}/items",9794 "parameter": "items[](local_shell_call)",9795 "location": "body",9796 "type": "object",9797 "required": false,9798 "default": null,9799 "minimum": null,9800 "maximum": null,9801 "enum": null,9802 "description": "A tool call to run a command on the local shell.",9803 "compatible_models": [9804 "*"9805 ],9806 "beta_header": null,9807 "status": [9808 "DOCUMENTED"9809 ],9810 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9811 "variant": "local_shell_call",9812 "schema_ref": "LocalShellToolCall"9813 },9814 {9815 "provider": "openai",9816 "endpoint": "POST /v1/conversations/{conversation_id}/items",9817 "parameter": "items[](local_shell_call).type",9818 "location": "body",9819 "type": "string",9820 "required": true,9821 "default": null,9822 "minimum": null,9823 "maximum": null,9824 "enum": [9825 "local_shell_call"9826 ],9827 "description": "The type of the local shell call. Always `local_shell_call`.",9828 "compatible_models": [9829 "*"9830 ],9831 "beta_header": null,9832 "status": [9833 "DOCUMENTED"9834 ],9835 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9836 },9837 {9838 "provider": "openai",9839 "endpoint": "POST /v1/conversations/{conversation_id}/items",9840 "parameter": "items[](local_shell_call).id",9841 "location": "body",9842 "type": "string",9843 "required": true,9844 "default": null,9845 "minimum": null,9846 "maximum": null,9847 "enum": null,9848 "description": "The unique ID of the local shell call.",9849 "compatible_models": [9850 "*"9851 ],9852 "beta_header": null,9853 "status": [9854 "DOCUMENTED"9855 ],9856 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9857 },9858 {9859 "provider": "openai",9860 "endpoint": "POST /v1/conversations/{conversation_id}/items",9861 "parameter": "items[](local_shell_call).call_id",9862 "location": "body",9863 "type": "string",9864 "required": true,9865 "default": null,9866 "minimum": null,9867 "maximum": null,9868 "enum": null,9869 "description": "The unique ID of the local shell tool call generated by the model.",9870 "compatible_models": [9871 "*"9872 ],9873 "beta_header": null,9874 "status": [9875 "DOCUMENTED"9876 ],9877 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9878 },9879 {9880 "provider": "openai",9881 "endpoint": "POST /v1/conversations/{conversation_id}/items",9882 "parameter": "items[](local_shell_call).action",9883 "location": "body",9884 "type": "object",9885 "required": true,9886 "default": null,9887 "minimum": null,9888 "maximum": null,9889 "enum": null,9890 "description": "Execute a shell command on the server.",9891 "compatible_models": [9892 "*"9893 ],9894 "beta_header": null,9895 "status": [9896 "DOCUMENTED"9897 ],9898 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9899 "schema_ref": "LocalShellExecAction"9900 },9901 {9902 "provider": "openai",9903 "endpoint": "POST /v1/conversations/{conversation_id}/items",9904 "parameter": "items[](local_shell_call).action.type",9905 "location": "body",9906 "type": "string",9907 "required": true,9908 "default": "exec",9909 "minimum": null,9910 "maximum": null,9911 "enum": [9912 "exec"9913 ],9914 "description": "The type of the local shell action. Always `exec`.",9915 "compatible_models": [9916 "*"9917 ],9918 "beta_header": null,9919 "status": [9920 "DOCUMENTED"9921 ],9922 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9923 },9924 {9925 "provider": "openai",9926 "endpoint": "POST /v1/conversations/{conversation_id}/items",9927 "parameter": "items[](local_shell_call).action.command",9928 "location": "body",9929 "type": "array<string>",9930 "required": true,9931 "default": null,9932 "minimum": null,9933 "maximum": null,9934 "enum": null,9935 "description": "The command to run.",9936 "compatible_models": [9937 "*"9938 ],9939 "beta_header": null,9940 "status": [9941 "DOCUMENTED"9942 ],9943 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"9944 },9945 {9946 "provider": "openai",9947 "endpoint": "POST /v1/conversations/{conversation_id}/items",9948 "parameter": "items[](local_shell_call).action.timeout_ms",9949 "location": "body",9950 "type": "integer | null",9951 "required": false,9952 "default": null,9953 "minimum": null,9954 "maximum": null,9955 "enum": null,9956 "description": "Optional timeout in milliseconds for the command.",9957 "compatible_models": [9958 "*"9959 ],9960 "beta_header": null,9961 "status": [9962 "DOCUMENTED"9963 ],9964 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9965 "nullable": true9966 },9967 {9968 "provider": "openai",9969 "endpoint": "POST /v1/conversations/{conversation_id}/items",9970 "parameter": "items[](local_shell_call).action.working_directory",9971 "location": "body",9972 "type": "string | null",9973 "required": false,9974 "default": null,9975 "minimum": null,9976 "maximum": null,9977 "enum": null,9978 "description": "Optional working directory to run the command in.",9979 "compatible_models": [9980 "*"9981 ],9982 "beta_header": null,9983 "status": [9984 "DOCUMENTED"9985 ],9986 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",9987 "nullable": true9988 },9989 {9990 "provider": "openai",9991 "endpoint": "POST /v1/conversations/{conversation_id}/items",9992 "parameter": "items[](local_shell_call).action.env",9993 "location": "body",9994 "type": "map<string,string>",9995 "required": true,9996 "default": null,9997 "minimum": null,9998 "maximum": null,9999 "enum": null,10000 "description": "Environment variables to set for the command.",10001 "compatible_models": [10002 "*"10003 ],10004 "beta_header": null,10005 "status": [10006 "DOCUMENTED"10007 ],10008 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10009 },10010 {10011 "provider": "openai",10012 "endpoint": "POST /v1/conversations/{conversation_id}/items",10013 "parameter": "items[](local_shell_call).action.user",10014 "location": "body",10015 "type": "string | null",10016 "required": false,10017 "default": null,10018 "minimum": null,10019 "maximum": null,10020 "enum": null,10021 "description": "Optional user to run the command as.",10022 "compatible_models": [10023 "*"10024 ],10025 "beta_header": null,10026 "status": [10027 "DOCUMENTED"10028 ],10029 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10030 "nullable": true10031 },10032 {10033 "provider": "openai",10034 "endpoint": "POST /v1/conversations/{conversation_id}/items",10035 "parameter": "items[](local_shell_call).status",10036 "location": "body",10037 "type": "string",10038 "required": true,10039 "default": null,10040 "minimum": null,10041 "maximum": null,10042 "enum": [10043 "in_progress",10044 "completed",10045 "incomplete"10046 ],10047 "description": "The status of the local shell call.",10048 "compatible_models": [10049 "*"10050 ],10051 "beta_header": null,10052 "status": [10053 "DOCUMENTED"10054 ],10055 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10056 },10057 {10058 "provider": "openai",10059 "endpoint": "POST /v1/conversations/{conversation_id}/items",10060 "parameter": "items[](local_shell_call_output)",10061 "location": "body",10062 "type": "object",10063 "required": false,10064 "default": null,10065 "minimum": null,10066 "maximum": null,10067 "enum": null,10068 "description": "The output of a local shell tool call.",10069 "compatible_models": [10070 "*"10071 ],10072 "beta_header": null,10073 "status": [10074 "DOCUMENTED"10075 ],10076 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10077 "variant": "local_shell_call_output",10078 "schema_ref": "LocalShellToolCallOutput"10079 },10080 {10081 "provider": "openai",10082 "endpoint": "POST /v1/conversations/{conversation_id}/items",10083 "parameter": "items[](local_shell_call_output).type",10084 "location": "body",10085 "type": "string",10086 "required": true,10087 "default": null,10088 "minimum": null,10089 "maximum": null,10090 "enum": [10091 "local_shell_call_output"10092 ],10093 "description": "The type of the local shell tool call output. Always `local_shell_call_output`.",10094 "compatible_models": [10095 "*"10096 ],10097 "beta_header": null,10098 "status": [10099 "DOCUMENTED"10100 ],10101 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10102 },10103 {10104 "provider": "openai",10105 "endpoint": "POST /v1/conversations/{conversation_id}/items",10106 "parameter": "items[](local_shell_call_output).id",10107 "location": "body",10108 "type": "string",10109 "required": true,10110 "default": null,10111 "minimum": null,10112 "maximum": null,10113 "enum": null,10114 "description": "The unique ID of the local shell tool call generated by the model.",10115 "compatible_models": [10116 "*"10117 ],10118 "beta_header": null,10119 "status": [10120 "DOCUMENTED"10121 ],10122 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10123 },10124 {10125 "provider": "openai",10126 "endpoint": "POST /v1/conversations/{conversation_id}/items",10127 "parameter": "items[](local_shell_call_output).output",10128 "location": "body",10129 "type": "string",10130 "required": true,10131 "default": null,10132 "minimum": null,10133 "maximum": null,10134 "enum": null,10135 "description": "A JSON string of the output of the local shell tool call.",10136 "compatible_models": [10137 "*"10138 ],10139 "beta_header": null,10140 "status": [10141 "DOCUMENTED"10142 ],10143 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10144 },10145 {10146 "provider": "openai",10147 "endpoint": "POST /v1/conversations/{conversation_id}/items",10148 "parameter": "items[](local_shell_call_output).status",10149 "location": "body",10150 "type": "string | null",10151 "required": false,10152 "default": null,10153 "minimum": null,10154 "maximum": null,10155 "enum": [10156 "in_progress",10157 "completed",10158 "incomplete"10159 ],10160 "description": "The status of the item. One of `in_progress`, `completed`, or `incomplete`.",10161 "compatible_models": [10162 "*"10163 ],10164 "beta_header": null,10165 "status": [10166 "DOCUMENTED"10167 ],10168 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10169 "nullable": true10170 },10171 {10172 "provider": "openai",10173 "endpoint": "POST /v1/conversations/{conversation_id}/items",10174 "parameter": "items[](shell_call)",10175 "location": "body",10176 "type": "object",10177 "required": false,10178 "default": null,10179 "minimum": null,10180 "maximum": null,10181 "enum": null,10182 "description": "A tool representing a request to execute one or more shell commands.",10183 "compatible_models": [10184 "*"10185 ],10186 "beta_header": null,10187 "status": [10188 "DOCUMENTED"10189 ],10190 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10191 "variant": "shell_call",10192 "schema_ref": "FunctionShellCallItemParam"10193 },10194 {10195 "provider": "openai",10196 "endpoint": "POST /v1/conversations/{conversation_id}/items",10197 "parameter": "items[](shell_call).id",10198 "location": "body",10199 "type": "string | null",10200 "required": false,10201 "default": null,10202 "minimum": null,10203 "maximum": null,10204 "enum": null,10205 "description": "The unique ID of the shell tool call. Populated when this item is returned via API.",10206 "compatible_models": [10207 "*"10208 ],10209 "beta_header": null,10210 "status": [10211 "DOCUMENTED"10212 ],10213 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10214 "nullable": true10215 },10216 {10217 "provider": "openai",10218 "endpoint": "POST /v1/conversations/{conversation_id}/items",10219 "parameter": "items[](shell_call).call_id",10220 "location": "body",10221 "type": "string",10222 "required": true,10223 "default": null,10224 "minimum": null,10225 "maximum": null,10226 "enum": null,10227 "description": "The unique ID of the shell tool call generated by the model.",10228 "compatible_models": [10229 "*"10230 ],10231 "beta_header": null,10232 "status": [10233 "DOCUMENTED"10234 ],10235 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10236 },10237 {10238 "provider": "openai",10239 "endpoint": "POST /v1/conversations/{conversation_id}/items",10240 "parameter": "items[](shell_call).caller",10241 "location": "body",10242 "type": "object<direct> | object<program>",10243 "required": false,10244 "default": null,10245 "minimum": null,10246 "maximum": null,10247 "enum": null,10248 "description": "The execution context that produced this tool call.",10249 "compatible_models": [10250 "*"10251 ],10252 "beta_header": null,10253 "status": [10254 "DOCUMENTED"10255 ],10256 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10257 "nullable": true10258 },10259 {10260 "provider": "openai",10261 "endpoint": "POST /v1/conversations/{conversation_id}/items",10262 "parameter": "items[](shell_call).caller(direct)",10263 "location": "body",10264 "type": "object",10265 "required": false,10266 "default": null,10267 "minimum": null,10268 "maximum": null,10269 "enum": null,10270 "description": "",10271 "compatible_models": [10272 "*"10273 ],10274 "beta_header": null,10275 "status": [10276 "DOCUMENTED"10277 ],10278 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10279 "variant": "direct",10280 "schema_ref": "DirectToolCallCallerParam"10281 },10282 {10283 "provider": "openai",10284 "endpoint": "POST /v1/conversations/{conversation_id}/items",10285 "parameter": "items[](shell_call).caller(program)",10286 "location": "body",10287 "type": "object",10288 "required": false,10289 "default": null,10290 "minimum": null,10291 "maximum": null,10292 "enum": null,10293 "description": "",10294 "compatible_models": [10295 "*"10296 ],10297 "beta_header": null,10298 "status": [10299 "DOCUMENTED"10300 ],10301 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10302 "variant": "program",10303 "schema_ref": "ProgramToolCallCallerParam"10304 },10305 {10306 "provider": "openai",10307 "endpoint": "POST /v1/conversations/{conversation_id}/items",10308 "parameter": "items[](shell_call).type",10309 "location": "body",10310 "type": "string",10311 "required": true,10312 "default": "shell_call",10313 "minimum": null,10314 "maximum": null,10315 "enum": [10316 "shell_call"10317 ],10318 "description": "The type of the item. Always `shell_call`.",10319 "compatible_models": [10320 "*"10321 ],10322 "beta_header": null,10323 "status": [10324 "DOCUMENTED"10325 ],10326 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10327 },10328 {10329 "provider": "openai",10330 "endpoint": "POST /v1/conversations/{conversation_id}/items",10331 "parameter": "items[](shell_call).action",10332 "location": "body",10333 "type": "object",10334 "required": true,10335 "default": null,10336 "minimum": null,10337 "maximum": null,10338 "enum": null,10339 "description": "The shell commands and limits that describe how to run the tool call.",10340 "compatible_models": [10341 "*"10342 ],10343 "beta_header": null,10344 "status": [10345 "DOCUMENTED"10346 ],10347 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10348 "schema_ref": "FunctionShellActionParam"10349 },10350 {10351 "provider": "openai",10352 "endpoint": "POST /v1/conversations/{conversation_id}/items",10353 "parameter": "items[](shell_call).action.commands",10354 "location": "body",10355 "type": "array<string>",10356 "required": true,10357 "default": null,10358 "minimum": null,10359 "maximum": null,10360 "enum": null,10361 "description": "Ordered shell commands for the execution environment to run.",10362 "compatible_models": [10363 "*"10364 ],10365 "beta_header": null,10366 "status": [10367 "DOCUMENTED"10368 ],10369 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10370 },10371 {10372 "provider": "openai",10373 "endpoint": "POST /v1/conversations/{conversation_id}/items",10374 "parameter": "items[](shell_call).action.timeout_ms",10375 "location": "body",10376 "type": "integer | null",10377 "required": false,10378 "default": null,10379 "minimum": null,10380 "maximum": null,10381 "enum": null,10382 "description": "Maximum wall-clock time in milliseconds to allow the shell commands to run.",10383 "compatible_models": [10384 "*"10385 ],10386 "beta_header": null,10387 "status": [10388 "DOCUMENTED"10389 ],10390 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10391 "nullable": true10392 },10393 {10394 "provider": "openai",10395 "endpoint": "POST /v1/conversations/{conversation_id}/items",10396 "parameter": "items[](shell_call).action.max_output_length",10397 "location": "body",10398 "type": "integer | null",10399 "required": false,10400 "default": null,10401 "minimum": null,10402 "maximum": null,10403 "enum": null,10404 "description": "Maximum number of UTF-8 characters to capture from combined stdout and stderr output.",10405 "compatible_models": [10406 "*"10407 ],10408 "beta_header": null,10409 "status": [10410 "DOCUMENTED"10411 ],10412 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10413 "nullable": true10414 },10415 {10416 "provider": "openai",10417 "endpoint": "POST /v1/conversations/{conversation_id}/items",10418 "parameter": "items[](shell_call).status",10419 "location": "body",10420 "type": "string | null",10421 "required": false,10422 "default": null,10423 "minimum": null,10424 "maximum": null,10425 "enum": [10426 "in_progress",10427 "completed",10428 "incomplete"10429 ],10430 "description": "The status of the shell call. One of `in_progress`, `completed`, or `incomplete`.",10431 "compatible_models": [10432 "*"10433 ],10434 "beta_header": null,10435 "status": [10436 "DOCUMENTED"10437 ],10438 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10439 "nullable": true10440 },10441 {10442 "provider": "openai",10443 "endpoint": "POST /v1/conversations/{conversation_id}/items",10444 "parameter": "items[](shell_call).environment",10445 "location": "body",10446 "type": "object<local> | object<container_reference>",10447 "required": false,10448 "default": null,10449 "minimum": null,10450 "maximum": null,10451 "enum": null,10452 "description": "The environment to execute the shell commands in.",10453 "compatible_models": [10454 "*"10455 ],10456 "beta_header": null,10457 "status": [10458 "DOCUMENTED"10459 ],10460 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10461 "nullable": true10462 },10463 {10464 "provider": "openai",10465 "endpoint": "POST /v1/conversations/{conversation_id}/items",10466 "parameter": "items[](shell_call).environment(local)",10467 "location": "body",10468 "type": "object",10469 "required": false,10470 "default": null,10471 "minimum": null,10472 "maximum": null,10473 "enum": null,10474 "description": "",10475 "compatible_models": [10476 "*"10477 ],10478 "beta_header": null,10479 "status": [10480 "DOCUMENTED"10481 ],10482 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10483 "variant": "local",10484 "schema_ref": "LocalEnvironmentParam"10485 },10486 {10487 "provider": "openai",10488 "endpoint": "POST /v1/conversations/{conversation_id}/items",10489 "parameter": "items[](shell_call).environment(container_reference)",10490 "location": "body",10491 "type": "object",10492 "required": false,10493 "default": null,10494 "minimum": null,10495 "maximum": null,10496 "enum": null,10497 "description": "",10498 "compatible_models": [10499 "*"10500 ],10501 "beta_header": null,10502 "status": [10503 "DOCUMENTED"10504 ],10505 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10506 "variant": "container_reference",10507 "schema_ref": "ContainerReferenceParam"10508 },10509 {10510 "provider": "openai",10511 "endpoint": "POST /v1/conversations/{conversation_id}/items",10512 "parameter": "items[](shell_call_output)",10513 "location": "body",10514 "type": "object",10515 "required": false,10516 "default": null,10517 "minimum": null,10518 "maximum": null,10519 "enum": null,10520 "description": "The streamed output items emitted by a shell tool call.",10521 "compatible_models": [10522 "*"10523 ],10524 "beta_header": null,10525 "status": [10526 "DOCUMENTED"10527 ],10528 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10529 "variant": "shell_call_output",10530 "schema_ref": "FunctionShellCallOutputItemParam"10531 },10532 {10533 "provider": "openai",10534 "endpoint": "POST /v1/conversations/{conversation_id}/items",10535 "parameter": "items[](shell_call_output).id",10536 "location": "body",10537 "type": "string | null",10538 "required": false,10539 "default": null,10540 "minimum": null,10541 "maximum": null,10542 "enum": null,10543 "description": "The unique ID of the shell tool call output. Populated when this item is returned via API.",10544 "compatible_models": [10545 "*"10546 ],10547 "beta_header": null,10548 "status": [10549 "DOCUMENTED"10550 ],10551 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10552 "nullable": true10553 },10554 {10555 "provider": "openai",10556 "endpoint": "POST /v1/conversations/{conversation_id}/items",10557 "parameter": "items[](shell_call_output).call_id",10558 "location": "body",10559 "type": "string",10560 "required": true,10561 "default": null,10562 "minimum": null,10563 "maximum": null,10564 "enum": null,10565 "description": "The unique ID of the shell tool call generated by the model.",10566 "compatible_models": [10567 "*"10568 ],10569 "beta_header": null,10570 "status": [10571 "DOCUMENTED"10572 ],10573 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10574 },10575 {10576 "provider": "openai",10577 "endpoint": "POST /v1/conversations/{conversation_id}/items",10578 "parameter": "items[](shell_call_output).caller",10579 "location": "body",10580 "type": "object<direct> | object<program>",10581 "required": false,10582 "default": null,10583 "minimum": null,10584 "maximum": null,10585 "enum": null,10586 "description": "The execution context that produced this tool call.",10587 "compatible_models": [10588 "*"10589 ],10590 "beta_header": null,10591 "status": [10592 "DOCUMENTED"10593 ],10594 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10595 "nullable": true10596 },10597 {10598 "provider": "openai",10599 "endpoint": "POST /v1/conversations/{conversation_id}/items",10600 "parameter": "items[](shell_call_output).caller(direct)",10601 "location": "body",10602 "type": "object",10603 "required": false,10604 "default": null,10605 "minimum": null,10606 "maximum": null,10607 "enum": null,10608 "description": "",10609 "compatible_models": [10610 "*"10611 ],10612 "beta_header": null,10613 "status": [10614 "DOCUMENTED"10615 ],10616 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10617 "variant": "direct",10618 "schema_ref": "DirectToolCallCallerParam"10619 },10620 {10621 "provider": "openai",10622 "endpoint": "POST /v1/conversations/{conversation_id}/items",10623 "parameter": "items[](shell_call_output).caller(program)",10624 "location": "body",10625 "type": "object",10626 "required": false,10627 "default": null,10628 "minimum": null,10629 "maximum": null,10630 "enum": null,10631 "description": "",10632 "compatible_models": [10633 "*"10634 ],10635 "beta_header": null,10636 "status": [10637 "DOCUMENTED"10638 ],10639 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10640 "variant": "program",10641 "schema_ref": "ProgramToolCallCallerParam"10642 },10643 {10644 "provider": "openai",10645 "endpoint": "POST /v1/conversations/{conversation_id}/items",10646 "parameter": "items[](shell_call_output).type",10647 "location": "body",10648 "type": "string",10649 "required": true,10650 "default": "shell_call_output",10651 "minimum": null,10652 "maximum": null,10653 "enum": [10654 "shell_call_output"10655 ],10656 "description": "The type of the item. Always `shell_call_output`.",10657 "compatible_models": [10658 "*"10659 ],10660 "beta_header": null,10661 "status": [10662 "DOCUMENTED"10663 ],10664 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10665 },10666 {10667 "provider": "openai",10668 "endpoint": "POST /v1/conversations/{conversation_id}/items",10669 "parameter": "items[](shell_call_output).output",10670 "location": "body",10671 "type": "array<object>",10672 "required": true,10673 "default": null,10674 "minimum": null,10675 "maximum": null,10676 "enum": null,10677 "description": "Captured chunks of stdout and stderr output, along with their associated outcomes.",10678 "compatible_models": [10679 "*"10680 ],10681 "beta_header": null,10682 "status": [10683 "DOCUMENTED"10684 ],10685 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10686 },10687 {10688 "provider": "openai",10689 "endpoint": "POST /v1/conversations/{conversation_id}/items",10690 "parameter": "items[](shell_call_output).output[]",10691 "location": "body",10692 "type": "object",10693 "required": false,10694 "default": null,10695 "minimum": null,10696 "maximum": null,10697 "enum": null,10698 "description": "Captured stdout and stderr for a portion of a shell tool call output.",10699 "compatible_models": [10700 "*"10701 ],10702 "beta_header": null,10703 "status": [10704 "DOCUMENTED"10705 ],10706 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10707 "schema_ref": "FunctionShellCallOutputContentParam"10708 },10709 {10710 "provider": "openai",10711 "endpoint": "POST /v1/conversations/{conversation_id}/items",10712 "parameter": "items[](shell_call_output).status",10713 "location": "body",10714 "type": "string | null",10715 "required": false,10716 "default": null,10717 "minimum": null,10718 "maximum": null,10719 "enum": [10720 "in_progress",10721 "completed",10722 "incomplete"10723 ],10724 "description": "The status of the shell call output.",10725 "compatible_models": [10726 "*"10727 ],10728 "beta_header": null,10729 "status": [10730 "DOCUMENTED"10731 ],10732 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10733 "nullable": true10734 },10735 {10736 "provider": "openai",10737 "endpoint": "POST /v1/conversations/{conversation_id}/items",10738 "parameter": "items[](shell_call_output).max_output_length",10739 "location": "body",10740 "type": "integer | null",10741 "required": false,10742 "default": null,10743 "minimum": null,10744 "maximum": null,10745 "enum": null,10746 "description": "The maximum number of UTF-8 characters captured for this shell call's combined output.",10747 "compatible_models": [10748 "*"10749 ],10750 "beta_header": null,10751 "status": [10752 "DOCUMENTED"10753 ],10754 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10755 "nullable": true10756 },10757 {10758 "provider": "openai",10759 "endpoint": "POST /v1/conversations/{conversation_id}/items",10760 "parameter": "items[](apply_patch_call)",10761 "location": "body",10762 "type": "object",10763 "required": false,10764 "default": null,10765 "minimum": null,10766 "maximum": null,10767 "enum": null,10768 "description": "A tool call representing a request to create, delete, or update files using diff patches.",10769 "compatible_models": [10770 "*"10771 ],10772 "beta_header": null,10773 "status": [10774 "DOCUMENTED"10775 ],10776 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10777 "variant": "apply_patch_call",10778 "schema_ref": "ApplyPatchToolCallItemParam"10779 },10780 {10781 "provider": "openai",10782 "endpoint": "POST /v1/conversations/{conversation_id}/items",10783 "parameter": "items[](apply_patch_call).type",10784 "location": "body",10785 "type": "string",10786 "required": true,10787 "default": "apply_patch_call",10788 "minimum": null,10789 "maximum": null,10790 "enum": [10791 "apply_patch_call"10792 ],10793 "description": "The type of the item. Always `apply_patch_call`.",10794 "compatible_models": [10795 "*"10796 ],10797 "beta_header": null,10798 "status": [10799 "DOCUMENTED"10800 ],10801 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10802 },10803 {10804 "provider": "openai",10805 "endpoint": "POST /v1/conversations/{conversation_id}/items",10806 "parameter": "items[](apply_patch_call).id",10807 "location": "body",10808 "type": "string | null",10809 "required": false,10810 "default": null,10811 "minimum": null,10812 "maximum": null,10813 "enum": null,10814 "description": "The unique ID of the apply patch tool call. Populated when this item is returned via API.",10815 "compatible_models": [10816 "*"10817 ],10818 "beta_header": null,10819 "status": [10820 "DOCUMENTED"10821 ],10822 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10823 "nullable": true10824 },10825 {10826 "provider": "openai",10827 "endpoint": "POST /v1/conversations/{conversation_id}/items",10828 "parameter": "items[](apply_patch_call).call_id",10829 "location": "body",10830 "type": "string",10831 "required": true,10832 "default": null,10833 "minimum": null,10834 "maximum": null,10835 "enum": null,10836 "description": "The unique ID of the apply patch tool call generated by the model.",10837 "compatible_models": [10838 "*"10839 ],10840 "beta_header": null,10841 "status": [10842 "DOCUMENTED"10843 ],10844 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"10845 },10846 {10847 "provider": "openai",10848 "endpoint": "POST /v1/conversations/{conversation_id}/items",10849 "parameter": "items[](apply_patch_call).caller",10850 "location": "body",10851 "type": "object<direct> | object<program>",10852 "required": false,10853 "default": null,10854 "minimum": null,10855 "maximum": null,10856 "enum": null,10857 "description": "The execution context that produced this tool call.",10858 "compatible_models": [10859 "*"10860 ],10861 "beta_header": null,10862 "status": [10863 "DOCUMENTED"10864 ],10865 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10866 "nullable": true10867 },10868 {10869 "provider": "openai",10870 "endpoint": "POST /v1/conversations/{conversation_id}/items",10871 "parameter": "items[](apply_patch_call).caller(direct)",10872 "location": "body",10873 "type": "object",10874 "required": false,10875 "default": null,10876 "minimum": null,10877 "maximum": null,10878 "enum": null,10879 "description": "",10880 "compatible_models": [10881 "*"10882 ],10883 "beta_header": null,10884 "status": [10885 "DOCUMENTED"10886 ],10887 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10888 "variant": "direct",10889 "schema_ref": "DirectToolCallCallerParam"10890 },10891 {10892 "provider": "openai",10893 "endpoint": "POST /v1/conversations/{conversation_id}/items",10894 "parameter": "items[](apply_patch_call).caller(program)",10895 "location": "body",10896 "type": "object",10897 "required": false,10898 "default": null,10899 "minimum": null,10900 "maximum": null,10901 "enum": null,10902 "description": "",10903 "compatible_models": [10904 "*"10905 ],10906 "beta_header": null,10907 "status": [10908 "DOCUMENTED"10909 ],10910 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10911 "variant": "program",10912 "schema_ref": "ProgramToolCallCallerParam"10913 },10914 {10915 "provider": "openai",10916 "endpoint": "POST /v1/conversations/{conversation_id}/items",10917 "parameter": "items[](apply_patch_call).status",10918 "location": "body",10919 "type": "string",10920 "required": true,10921 "default": null,10922 "minimum": null,10923 "maximum": null,10924 "enum": [10925 "in_progress",10926 "completed"10927 ],10928 "description": "The status of the apply patch tool call. One of `in_progress` or `completed`.",10929 "compatible_models": [10930 "*"10931 ],10932 "beta_header": null,10933 "status": [10934 "DOCUMENTED"10935 ],10936 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10937 "schema_ref": "ApplyPatchCallStatusParam"10938 },10939 {10940 "provider": "openai",10941 "endpoint": "POST /v1/conversations/{conversation_id}/items",10942 "parameter": "items[](apply_patch_call).operation",10943 "location": "body",10944 "type": "object<create_file> | object<delete_file> | object<update_file>",10945 "required": true,10946 "default": null,10947 "minimum": null,10948 "maximum": null,10949 "enum": null,10950 "description": "The specific create, delete, or update instruction for the apply_patch tool call.",10951 "compatible_models": [10952 "*"10953 ],10954 "beta_header": null,10955 "status": [10956 "DOCUMENTED"10957 ],10958 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10959 "schema_ref": "ApplyPatchOperationParam"10960 },10961 {10962 "provider": "openai",10963 "endpoint": "POST /v1/conversations/{conversation_id}/items",10964 "parameter": "items[](apply_patch_call).operation(create_file)",10965 "location": "body",10966 "type": "object",10967 "required": true,10968 "default": null,10969 "minimum": null,10970 "maximum": null,10971 "enum": null,10972 "description": "Instruction for creating a new file via the apply_patch tool.",10973 "compatible_models": [10974 "*"10975 ],10976 "beta_header": null,10977 "status": [10978 "DOCUMENTED"10979 ],10980 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",10981 "variant": "create_file",10982 "schema_ref": "ApplyPatchCreateFileOperationParam"10983 },10984 {10985 "provider": "openai",10986 "endpoint": "POST /v1/conversations/{conversation_id}/items",10987 "parameter": "items[](apply_patch_call).operation(delete_file)",10988 "location": "body",10989 "type": "object",10990 "required": true,10991 "default": null,10992 "minimum": null,10993 "maximum": null,10994 "enum": null,10995 "description": "Instruction for deleting an existing file via the apply_patch tool.",10996 "compatible_models": [10997 "*"10998 ],10999 "beta_header": null,11000 "status": [11001 "DOCUMENTED"11002 ],11003 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11004 "variant": "delete_file",11005 "schema_ref": "ApplyPatchDeleteFileOperationParam"11006 },11007 {11008 "provider": "openai",11009 "endpoint": "POST /v1/conversations/{conversation_id}/items",11010 "parameter": "items[](apply_patch_call).operation(update_file)",11011 "location": "body",11012 "type": "object",11013 "required": true,11014 "default": null,11015 "minimum": null,11016 "maximum": null,11017 "enum": null,11018 "description": "Instruction for updating an existing file via the apply_patch tool.",11019 "compatible_models": [11020 "*"11021 ],11022 "beta_header": null,11023 "status": [11024 "DOCUMENTED"11025 ],11026 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11027 "variant": "update_file",11028 "schema_ref": "ApplyPatchUpdateFileOperationParam"11029 },11030 {11031 "provider": "openai",11032 "endpoint": "POST /v1/conversations/{conversation_id}/items",11033 "parameter": "items[](apply_patch_call_output)",11034 "location": "body",11035 "type": "object",11036 "required": false,11037 "default": null,11038 "minimum": null,11039 "maximum": null,11040 "enum": null,11041 "description": "The streamed output emitted by an apply patch tool call.",11042 "compatible_models": [11043 "*"11044 ],11045 "beta_header": null,11046 "status": [11047 "DOCUMENTED"11048 ],11049 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11050 "variant": "apply_patch_call_output",11051 "schema_ref": "ApplyPatchToolCallOutputItemParam"11052 },11053 {11054 "provider": "openai",11055 "endpoint": "POST /v1/conversations/{conversation_id}/items",11056 "parameter": "items[](apply_patch_call_output).type",11057 "location": "body",11058 "type": "string",11059 "required": true,11060 "default": "apply_patch_call_output",11061 "minimum": null,11062 "maximum": null,11063 "enum": [11064 "apply_patch_call_output"11065 ],11066 "description": "The type of the item. Always `apply_patch_call_output`.",11067 "compatible_models": [11068 "*"11069 ],11070 "beta_header": null,11071 "status": [11072 "DOCUMENTED"11073 ],11074 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11075 },11076 {11077 "provider": "openai",11078 "endpoint": "POST /v1/conversations/{conversation_id}/items",11079 "parameter": "items[](apply_patch_call_output).id",11080 "location": "body",11081 "type": "string | null",11082 "required": false,11083 "default": null,11084 "minimum": null,11085 "maximum": null,11086 "enum": null,11087 "description": "The unique ID of the apply patch tool call output. Populated when this item is returned via API.",11088 "compatible_models": [11089 "*"11090 ],11091 "beta_header": null,11092 "status": [11093 "DOCUMENTED"11094 ],11095 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11096 "nullable": true11097 },11098 {11099 "provider": "openai",11100 "endpoint": "POST /v1/conversations/{conversation_id}/items",11101 "parameter": "items[](apply_patch_call_output).call_id",11102 "location": "body",11103 "type": "string",11104 "required": true,11105 "default": null,11106 "minimum": null,11107 "maximum": null,11108 "enum": null,11109 "description": "The unique ID of the apply patch tool call generated by the model.",11110 "compatible_models": [11111 "*"11112 ],11113 "beta_header": null,11114 "status": [11115 "DOCUMENTED"11116 ],11117 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11118 },11119 {11120 "provider": "openai",11121 "endpoint": "POST /v1/conversations/{conversation_id}/items",11122 "parameter": "items[](apply_patch_call_output).caller",11123 "location": "body",11124 "type": "object<direct> | object<program>",11125 "required": false,11126 "default": null,11127 "minimum": null,11128 "maximum": null,11129 "enum": null,11130 "description": "The execution context that produced this tool call.",11131 "compatible_models": [11132 "*"11133 ],11134 "beta_header": null,11135 "status": [11136 "DOCUMENTED"11137 ],11138 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11139 "nullable": true11140 },11141 {11142 "provider": "openai",11143 "endpoint": "POST /v1/conversations/{conversation_id}/items",11144 "parameter": "items[](apply_patch_call_output).caller(direct)",11145 "location": "body",11146 "type": "object",11147 "required": false,11148 "default": null,11149 "minimum": null,11150 "maximum": null,11151 "enum": null,11152 "description": "",11153 "compatible_models": [11154 "*"11155 ],11156 "beta_header": null,11157 "status": [11158 "DOCUMENTED"11159 ],11160 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11161 "variant": "direct",11162 "schema_ref": "DirectToolCallCallerParam"11163 },11164 {11165 "provider": "openai",11166 "endpoint": "POST /v1/conversations/{conversation_id}/items",11167 "parameter": "items[](apply_patch_call_output).caller(program)",11168 "location": "body",11169 "type": "object",11170 "required": false,11171 "default": null,11172 "minimum": null,11173 "maximum": null,11174 "enum": null,11175 "description": "",11176 "compatible_models": [11177 "*"11178 ],11179 "beta_header": null,11180 "status": [11181 "DOCUMENTED"11182 ],11183 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11184 "variant": "program",11185 "schema_ref": "ProgramToolCallCallerParam"11186 },11187 {11188 "provider": "openai",11189 "endpoint": "POST /v1/conversations/{conversation_id}/items",11190 "parameter": "items[](apply_patch_call_output).status",11191 "location": "body",11192 "type": "string",11193 "required": true,11194 "default": null,11195 "minimum": null,11196 "maximum": null,11197 "enum": [11198 "completed",11199 "failed"11200 ],11201 "description": "The status of the apply patch tool call output. One of `completed` or `failed`.",11202 "compatible_models": [11203 "*"11204 ],11205 "beta_header": null,11206 "status": [11207 "DOCUMENTED"11208 ],11209 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11210 "schema_ref": "ApplyPatchCallOutputStatusParam"11211 },11212 {11213 "provider": "openai",11214 "endpoint": "POST /v1/conversations/{conversation_id}/items",11215 "parameter": "items[](apply_patch_call_output).output",11216 "location": "body",11217 "type": "string | null",11218 "required": false,11219 "default": null,11220 "minimum": null,11221 "maximum": null,11222 "enum": null,11223 "description": "Optional human-readable log text from the apply patch tool (e.g., patch results or errors).",11224 "compatible_models": [11225 "*"11226 ],11227 "beta_header": null,11228 "status": [11229 "DOCUMENTED"11230 ],11231 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11232 "nullable": true11233 },11234 {11235 "provider": "openai",11236 "endpoint": "POST /v1/conversations/{conversation_id}/items",11237 "parameter": "items[](mcp_list_tools)",11238 "location": "body",11239 "type": "object",11240 "required": false,11241 "default": null,11242 "minimum": null,11243 "maximum": null,11244 "enum": null,11245 "description": "A list of tools available on an MCP server.",11246 "compatible_models": [11247 "*"11248 ],11249 "beta_header": null,11250 "status": [11251 "DOCUMENTED"11252 ],11253 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11254 "variant": "mcp_list_tools",11255 "schema_ref": "MCPListTools"11256 },11257 {11258 "provider": "openai",11259 "endpoint": "POST /v1/conversations/{conversation_id}/items",11260 "parameter": "items[](mcp_list_tools).type",11261 "location": "body",11262 "type": "string",11263 "required": true,11264 "default": null,11265 "minimum": null,11266 "maximum": null,11267 "enum": [11268 "mcp_list_tools"11269 ],11270 "description": "The type of the item. Always `mcp_list_tools`.",11271 "compatible_models": [11272 "*"11273 ],11274 "beta_header": null,11275 "status": [11276 "DOCUMENTED"11277 ],11278 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11279 },11280 {11281 "provider": "openai",11282 "endpoint": "POST /v1/conversations/{conversation_id}/items",11283 "parameter": "items[](mcp_list_tools).id",11284 "location": "body",11285 "type": "string",11286 "required": true,11287 "default": null,11288 "minimum": null,11289 "maximum": null,11290 "enum": null,11291 "description": "The unique ID of the list.",11292 "compatible_models": [11293 "*"11294 ],11295 "beta_header": null,11296 "status": [11297 "DOCUMENTED"11298 ],11299 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11300 },11301 {11302 "provider": "openai",11303 "endpoint": "POST /v1/conversations/{conversation_id}/items",11304 "parameter": "items[](mcp_list_tools).server_label",11305 "location": "body",11306 "type": "string",11307 "required": true,11308 "default": null,11309 "minimum": null,11310 "maximum": null,11311 "enum": null,11312 "description": "The label of the MCP server.",11313 "compatible_models": [11314 "*"11315 ],11316 "beta_header": null,11317 "status": [11318 "DOCUMENTED"11319 ],11320 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11321 },11322 {11323 "provider": "openai",11324 "endpoint": "POST /v1/conversations/{conversation_id}/items",11325 "parameter": "items[](mcp_list_tools).tools",11326 "location": "body",11327 "type": "array<object>",11328 "required": true,11329 "default": null,11330 "minimum": null,11331 "maximum": null,11332 "enum": null,11333 "description": "The tools available on the server.",11334 "compatible_models": [11335 "*"11336 ],11337 "beta_header": null,11338 "status": [11339 "DOCUMENTED"11340 ],11341 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11342 },11343 {11344 "provider": "openai",11345 "endpoint": "POST /v1/conversations/{conversation_id}/items",11346 "parameter": "items[](mcp_list_tools).tools[]",11347 "location": "body",11348 "type": "object",11349 "required": false,11350 "default": null,11351 "minimum": null,11352 "maximum": null,11353 "enum": null,11354 "description": "A tool available on an MCP server.",11355 "compatible_models": [11356 "*"11357 ],11358 "beta_header": null,11359 "status": [11360 "DOCUMENTED"11361 ],11362 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11363 "schema_ref": "MCPListToolsTool"11364 },11365 {11366 "provider": "openai",11367 "endpoint": "POST /v1/conversations/{conversation_id}/items",11368 "parameter": "items[](mcp_list_tools).error",11369 "location": "body",11370 "type": "string | null",11371 "required": false,11372 "default": null,11373 "minimum": null,11374 "maximum": null,11375 "enum": null,11376 "description": "Error message if the server could not list tools.",11377 "compatible_models": [11378 "*"11379 ],11380 "beta_header": null,11381 "status": [11382 "DOCUMENTED"11383 ],11384 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11385 "nullable": true11386 },11387 {11388 "provider": "openai",11389 "endpoint": "POST /v1/conversations/{conversation_id}/items",11390 "parameter": "items[](mcp_approval_request)",11391 "location": "body",11392 "type": "object",11393 "required": false,11394 "default": null,11395 "minimum": null,11396 "maximum": null,11397 "enum": null,11398 "description": "A request for human approval of a tool invocation.",11399 "compatible_models": [11400 "*"11401 ],11402 "beta_header": null,11403 "status": [11404 "DOCUMENTED"11405 ],11406 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11407 "variant": "mcp_approval_request",11408 "schema_ref": "MCPApprovalRequest"11409 },11410 {11411 "provider": "openai",11412 "endpoint": "POST /v1/conversations/{conversation_id}/items",11413 "parameter": "items[](mcp_approval_request).type",11414 "location": "body",11415 "type": "string",11416 "required": true,11417 "default": null,11418 "minimum": null,11419 "maximum": null,11420 "enum": [11421 "mcp_approval_request"11422 ],11423 "description": "The type of the item. Always `mcp_approval_request`.",11424 "compatible_models": [11425 "*"11426 ],11427 "beta_header": null,11428 "status": [11429 "DOCUMENTED"11430 ],11431 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11432 },11433 {11434 "provider": "openai",11435 "endpoint": "POST /v1/conversations/{conversation_id}/items",11436 "parameter": "items[](mcp_approval_request).id",11437 "location": "body",11438 "type": "string",11439 "required": true,11440 "default": null,11441 "minimum": null,11442 "maximum": null,11443 "enum": null,11444 "description": "The unique ID of the approval request.",11445 "compatible_models": [11446 "*"11447 ],11448 "beta_header": null,11449 "status": [11450 "DOCUMENTED"11451 ],11452 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11453 },11454 {11455 "provider": "openai",11456 "endpoint": "POST /v1/conversations/{conversation_id}/items",11457 "parameter": "items[](mcp_approval_request).server_label",11458 "location": "body",11459 "type": "string",11460 "required": true,11461 "default": null,11462 "minimum": null,11463 "maximum": null,11464 "enum": null,11465 "description": "The label of the MCP server making the request.",11466 "compatible_models": [11467 "*"11468 ],11469 "beta_header": null,11470 "status": [11471 "DOCUMENTED"11472 ],11473 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11474 },11475 {11476 "provider": "openai",11477 "endpoint": "POST /v1/conversations/{conversation_id}/items",11478 "parameter": "items[](mcp_approval_request).name",11479 "location": "body",11480 "type": "string",11481 "required": true,11482 "default": null,11483 "minimum": null,11484 "maximum": null,11485 "enum": null,11486 "description": "The name of the tool to run.",11487 "compatible_models": [11488 "*"11489 ],11490 "beta_header": null,11491 "status": [11492 "DOCUMENTED"11493 ],11494 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11495 },11496 {11497 "provider": "openai",11498 "endpoint": "POST /v1/conversations/{conversation_id}/items",11499 "parameter": "items[](mcp_approval_request).arguments",11500 "location": "body",11501 "type": "string",11502 "required": true,11503 "default": null,11504 "minimum": null,11505 "maximum": null,11506 "enum": null,11507 "description": "A JSON string of arguments for the tool.",11508 "compatible_models": [11509 "*"11510 ],11511 "beta_header": null,11512 "status": [11513 "DOCUMENTED"11514 ],11515 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11516 },11517 {11518 "provider": "openai",11519 "endpoint": "POST /v1/conversations/{conversation_id}/items",11520 "parameter": "items[](mcp_approval_response)",11521 "location": "body",11522 "type": "object",11523 "required": false,11524 "default": null,11525 "minimum": null,11526 "maximum": null,11527 "enum": null,11528 "description": "A response to an MCP approval request.",11529 "compatible_models": [11530 "*"11531 ],11532 "beta_header": null,11533 "status": [11534 "DOCUMENTED"11535 ],11536 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11537 "variant": "mcp_approval_response",11538 "schema_ref": "MCPApprovalResponse"11539 },11540 {11541 "provider": "openai",11542 "endpoint": "POST /v1/conversations/{conversation_id}/items",11543 "parameter": "items[](mcp_approval_response).type",11544 "location": "body",11545 "type": "string",11546 "required": true,11547 "default": null,11548 "minimum": null,11549 "maximum": null,11550 "enum": [11551 "mcp_approval_response"11552 ],11553 "description": "The type of the item. Always `mcp_approval_response`.",11554 "compatible_models": [11555 "*"11556 ],11557 "beta_header": null,11558 "status": [11559 "DOCUMENTED"11560 ],11561 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11562 },11563 {11564 "provider": "openai",11565 "endpoint": "POST /v1/conversations/{conversation_id}/items",11566 "parameter": "items[](mcp_approval_response).id",11567 "location": "body",11568 "type": "string | null",11569 "required": false,11570 "default": null,11571 "minimum": null,11572 "maximum": null,11573 "enum": null,11574 "description": "The unique ID of the approval response",11575 "compatible_models": [11576 "*"11577 ],11578 "beta_header": null,11579 "status": [11580 "DOCUMENTED"11581 ],11582 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11583 "nullable": true11584 },11585 {11586 "provider": "openai",11587 "endpoint": "POST /v1/conversations/{conversation_id}/items",11588 "parameter": "items[](mcp_approval_response).approval_request_id",11589 "location": "body",11590 "type": "string",11591 "required": true,11592 "default": null,11593 "minimum": null,11594 "maximum": null,11595 "enum": null,11596 "description": "The ID of the approval request being answered.",11597 "compatible_models": [11598 "*"11599 ],11600 "beta_header": null,11601 "status": [11602 "DOCUMENTED"11603 ],11604 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11605 },11606 {11607 "provider": "openai",11608 "endpoint": "POST /v1/conversations/{conversation_id}/items",11609 "parameter": "items[](mcp_approval_response).approve",11610 "location": "body",11611 "type": "boolean",11612 "required": true,11613 "default": null,11614 "minimum": null,11615 "maximum": null,11616 "enum": null,11617 "description": "Whether the request was approved.",11618 "compatible_models": [11619 "*"11620 ],11621 "beta_header": null,11622 "status": [11623 "DOCUMENTED"11624 ],11625 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11626 },11627 {11628 "provider": "openai",11629 "endpoint": "POST /v1/conversations/{conversation_id}/items",11630 "parameter": "items[](mcp_approval_response).reason",11631 "location": "body",11632 "type": "string | null",11633 "required": false,11634 "default": null,11635 "minimum": null,11636 "maximum": null,11637 "enum": null,11638 "description": "Optional reason for the decision.",11639 "compatible_models": [11640 "*"11641 ],11642 "beta_header": null,11643 "status": [11644 "DOCUMENTED"11645 ],11646 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11647 "nullable": true11648 },11649 {11650 "provider": "openai",11651 "endpoint": "POST /v1/conversations/{conversation_id}/items",11652 "parameter": "items[](mcp_call)",11653 "location": "body",11654 "type": "object",11655 "required": false,11656 "default": null,11657 "minimum": null,11658 "maximum": null,11659 "enum": null,11660 "description": "An invocation of a tool on an MCP server.",11661 "compatible_models": [11662 "*"11663 ],11664 "beta_header": null,11665 "status": [11666 "DOCUMENTED"11667 ],11668 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11669 "variant": "mcp_call",11670 "schema_ref": "MCPToolCall"11671 },11672 {11673 "provider": "openai",11674 "endpoint": "POST /v1/conversations/{conversation_id}/items",11675 "parameter": "items[](mcp_call).type",11676 "location": "body",11677 "type": "string",11678 "required": true,11679 "default": null,11680 "minimum": null,11681 "maximum": null,11682 "enum": [11683 "mcp_call"11684 ],11685 "description": "The type of the item. Always `mcp_call`.",11686 "compatible_models": [11687 "*"11688 ],11689 "beta_header": null,11690 "status": [11691 "DOCUMENTED"11692 ],11693 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11694 },11695 {11696 "provider": "openai",11697 "endpoint": "POST /v1/conversations/{conversation_id}/items",11698 "parameter": "items[](mcp_call).id",11699 "location": "body",11700 "type": "string",11701 "required": true,11702 "default": null,11703 "minimum": null,11704 "maximum": null,11705 "enum": null,11706 "description": "The unique ID of the tool call.",11707 "compatible_models": [11708 "*"11709 ],11710 "beta_header": null,11711 "status": [11712 "DOCUMENTED"11713 ],11714 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11715 },11716 {11717 "provider": "openai",11718 "endpoint": "POST /v1/conversations/{conversation_id}/items",11719 "parameter": "items[](mcp_call).server_label",11720 "location": "body",11721 "type": "string",11722 "required": true,11723 "default": null,11724 "minimum": null,11725 "maximum": null,11726 "enum": null,11727 "description": "The label of the MCP server running the tool.",11728 "compatible_models": [11729 "*"11730 ],11731 "beta_header": null,11732 "status": [11733 "DOCUMENTED"11734 ],11735 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11736 },11737 {11738 "provider": "openai",11739 "endpoint": "POST /v1/conversations/{conversation_id}/items",11740 "parameter": "items[](mcp_call).name",11741 "location": "body",11742 "type": "string",11743 "required": true,11744 "default": null,11745 "minimum": null,11746 "maximum": null,11747 "enum": null,11748 "description": "The name of the tool that was run.",11749 "compatible_models": [11750 "*"11751 ],11752 "beta_header": null,11753 "status": [11754 "DOCUMENTED"11755 ],11756 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11757 },11758 {11759 "provider": "openai",11760 "endpoint": "POST /v1/conversations/{conversation_id}/items",11761 "parameter": "items[](mcp_call).arguments",11762 "location": "body",11763 "type": "string",11764 "required": true,11765 "default": null,11766 "minimum": null,11767 "maximum": null,11768 "enum": null,11769 "description": "A JSON string of the arguments passed to the tool.",11770 "compatible_models": [11771 "*"11772 ],11773 "beta_header": null,11774 "status": [11775 "DOCUMENTED"11776 ],11777 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11778 },11779 {11780 "provider": "openai",11781 "endpoint": "POST /v1/conversations/{conversation_id}/items",11782 "parameter": "items[](mcp_call).output",11783 "location": "body",11784 "type": "string | null",11785 "required": false,11786 "default": null,11787 "minimum": null,11788 "maximum": null,11789 "enum": null,11790 "description": "The output from the tool call.",11791 "compatible_models": [11792 "*"11793 ],11794 "beta_header": null,11795 "status": [11796 "DOCUMENTED"11797 ],11798 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11799 "nullable": true11800 },11801 {11802 "provider": "openai",11803 "endpoint": "POST /v1/conversations/{conversation_id}/items",11804 "parameter": "items[](mcp_call).error",11805 "location": "body",11806 "type": "object<mcp_protocol_error> | object<mcp_tool_execution_error> | object<http_error>",11807 "required": false,11808 "default": null,11809 "minimum": null,11810 "maximum": null,11811 "enum": null,11812 "description": "The error from the tool call, if any.",11813 "compatible_models": [11814 "*"11815 ],11816 "beta_header": null,11817 "status": [11818 "DOCUMENTED"11819 ],11820 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11821 "nullable": true11822 },11823 {11824 "provider": "openai",11825 "endpoint": "POST /v1/conversations/{conversation_id}/items",11826 "parameter": "items[](mcp_call).error(mcp_protocol_error)",11827 "location": "body",11828 "type": "object",11829 "required": false,11830 "default": null,11831 "minimum": null,11832 "maximum": null,11833 "enum": null,11834 "description": "",11835 "compatible_models": [11836 "*"11837 ],11838 "beta_header": null,11839 "status": [11840 "DOCUMENTED"11841 ],11842 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11843 "variant": "mcp_protocol_error",11844 "schema_ref": "MCPProtocolError"11845 },11846 {11847 "provider": "openai",11848 "endpoint": "POST /v1/conversations/{conversation_id}/items",11849 "parameter": "items[](mcp_call).error(mcp_tool_execution_error)",11850 "location": "body",11851 "type": "object",11852 "required": false,11853 "default": null,11854 "minimum": null,11855 "maximum": null,11856 "enum": null,11857 "description": "",11858 "compatible_models": [11859 "*"11860 ],11861 "beta_header": null,11862 "status": [11863 "DOCUMENTED"11864 ],11865 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11866 "variant": "mcp_tool_execution_error",11867 "schema_ref": "MCPToolExecutionError"11868 },11869 {11870 "provider": "openai",11871 "endpoint": "POST /v1/conversations/{conversation_id}/items",11872 "parameter": "items[](mcp_call).error(http_error)",11873 "location": "body",11874 "type": "object",11875 "required": false,11876 "default": null,11877 "minimum": null,11878 "maximum": null,11879 "enum": null,11880 "description": "",11881 "compatible_models": [11882 "*"11883 ],11884 "beta_header": null,11885 "status": [11886 "DOCUMENTED"11887 ],11888 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11889 "variant": "http_error",11890 "schema_ref": "HTTPError"11891 },11892 {11893 "provider": "openai",11894 "endpoint": "POST /v1/conversations/{conversation_id}/items",11895 "parameter": "items[](mcp_call).status",11896 "location": "body",11897 "type": "string",11898 "required": false,11899 "default": null,11900 "minimum": null,11901 "maximum": null,11902 "enum": [11903 "in_progress",11904 "completed",11905 "incomplete",11906 "calling",11907 "failed"11908 ],11909 "description": "The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`, or `failed`.",11910 "compatible_models": [11911 "*"11912 ],11913 "beta_header": null,11914 "status": [11915 "DOCUMENTED"11916 ],11917 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11918 "schema_ref": "MCPToolCallStatus"11919 },11920 {11921 "provider": "openai",11922 "endpoint": "POST /v1/conversations/{conversation_id}/items",11923 "parameter": "items[](mcp_call).approval_request_id",11924 "location": "body",11925 "type": "string | null",11926 "required": false,11927 "default": null,11928 "minimum": null,11929 "maximum": null,11930 "enum": null,11931 "description": "Unique identifier for the MCP tool call approval request. Include this value in a subsequent `mcp_approval_response` input to approve or reject the corresponding tool call.",11932 "compatible_models": [11933 "*"11934 ],11935 "beta_header": null,11936 "status": [11937 "DOCUMENTED"11938 ],11939 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11940 "nullable": true11941 },11942 {11943 "provider": "openai",11944 "endpoint": "POST /v1/conversations/{conversation_id}/items",11945 "parameter": "items[](custom_tool_call_output)",11946 "location": "body",11947 "type": "object",11948 "required": false,11949 "default": null,11950 "minimum": null,11951 "maximum": null,11952 "enum": null,11953 "description": "The output of a custom tool call from your code, being sent back to the model.",11954 "compatible_models": [11955 "*"11956 ],11957 "beta_header": null,11958 "status": [11959 "DOCUMENTED"11960 ],11961 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",11962 "variant": "custom_tool_call_output",11963 "schema_ref": "CustomToolCallOutput"11964 },11965 {11966 "provider": "openai",11967 "endpoint": "POST /v1/conversations/{conversation_id}/items",11968 "parameter": "items[](custom_tool_call_output).type",11969 "location": "body",11970 "type": "string",11971 "required": true,11972 "default": null,11973 "minimum": null,11974 "maximum": null,11975 "enum": [11976 "custom_tool_call_output"11977 ],11978 "description": "The type of the custom tool call output. Always `custom_tool_call_output`.",11979 "compatible_models": [11980 "*"11981 ],11982 "beta_header": null,11983 "status": [11984 "DOCUMENTED"11985 ],11986 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"11987 },11988 {11989 "provider": "openai",11990 "endpoint": "POST /v1/conversations/{conversation_id}/items",11991 "parameter": "items[](custom_tool_call_output).id",11992 "location": "body",11993 "type": "string",11994 "required": false,11995 "default": null,11996 "minimum": null,11997 "maximum": null,11998 "enum": null,11999 "description": "The unique ID of the custom tool call output in the OpenAI platform.",12000 "compatible_models": [12001 "*"12002 ],12003 "beta_header": null,12004 "status": [12005 "DOCUMENTED"12006 ],12007 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12008 },12009 {12010 "provider": "openai",12011 "endpoint": "POST /v1/conversations/{conversation_id}/items",12012 "parameter": "items[](custom_tool_call_output).call_id",12013 "location": "body",12014 "type": "string",12015 "required": true,12016 "default": null,12017 "minimum": null,12018 "maximum": null,12019 "enum": null,12020 "description": "The call ID, used to map this custom tool call output to a custom tool call.",12021 "compatible_models": [12022 "*"12023 ],12024 "beta_header": null,12025 "status": [12026 "DOCUMENTED"12027 ],12028 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12029 },12030 {12031 "provider": "openai",12032 "endpoint": "POST /v1/conversations/{conversation_id}/items",12033 "parameter": "items[](custom_tool_call_output).caller",12034 "location": "body",12035 "type": "object<direct> | object<program>",12036 "required": false,12037 "default": null,12038 "minimum": null,12039 "maximum": null,12040 "enum": null,12041 "description": "The execution context that produced this tool call.",12042 "compatible_models": [12043 "*"12044 ],12045 "beta_header": null,12046 "status": [12047 "DOCUMENTED"12048 ],12049 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12050 "nullable": true12051 },12052 {12053 "provider": "openai",12054 "endpoint": "POST /v1/conversations/{conversation_id}/items",12055 "parameter": "items[](custom_tool_call_output).caller(direct)",12056 "location": "body",12057 "type": "object",12058 "required": false,12059 "default": null,12060 "minimum": null,12061 "maximum": null,12062 "enum": null,12063 "description": "",12064 "compatible_models": [12065 "*"12066 ],12067 "beta_header": null,12068 "status": [12069 "DOCUMENTED"12070 ],12071 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12072 "variant": "direct",12073 "schema_ref": "DirectToolCallCallerParam"12074 },12075 {12076 "provider": "openai",12077 "endpoint": "POST /v1/conversations/{conversation_id}/items",12078 "parameter": "items[](custom_tool_call_output).caller(program)",12079 "location": "body",12080 "type": "object",12081 "required": false,12082 "default": null,12083 "minimum": null,12084 "maximum": null,12085 "enum": null,12086 "description": "",12087 "compatible_models": [12088 "*"12089 ],12090 "beta_header": null,12091 "status": [12092 "DOCUMENTED"12093 ],12094 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12095 "variant": "program",12096 "schema_ref": "ProgramToolCallCallerParam"12097 },12098 {12099 "provider": "openai",12100 "endpoint": "POST /v1/conversations/{conversation_id}/items",12101 "parameter": "items[](custom_tool_call_output).output",12102 "location": "body",12103 "type": "string | array<object<input_text> | object<input_image> | object<input_file>>",12104 "required": true,12105 "default": null,12106 "minimum": null,12107 "maximum": null,12108 "enum": null,12109 "description": "The output from the custom tool call generated by your code. Can be a string or an list of output content.",12110 "compatible_models": [12111 "*"12112 ],12113 "beta_header": null,12114 "status": [12115 "DOCUMENTED"12116 ],12117 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12118 },12119 {12120 "provider": "openai",12121 "endpoint": "POST /v1/conversations/{conversation_id}/items",12122 "parameter": "items[](custom_tool_call_output).output[]",12123 "location": "body",12124 "type": "array<object<input_text> | object<input_image> | object<input_file>>",12125 "required": false,12126 "default": null,12127 "minimum": null,12128 "maximum": null,12129 "enum": null,12130 "description": "Text, image, or file output of the custom tool call.",12131 "compatible_models": [12132 "*"12133 ],12134 "beta_header": null,12135 "status": [12136 "DOCUMENTED"12137 ],12138 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12139 },12140 {12141 "provider": "openai",12142 "endpoint": "POST /v1/conversations/{conversation_id}/items",12143 "parameter": "items[](custom_tool_call)",12144 "location": "body",12145 "type": "object",12146 "required": false,12147 "default": null,12148 "minimum": null,12149 "maximum": null,12150 "enum": null,12151 "description": "A call to a custom tool created by the model.",12152 "compatible_models": [12153 "*"12154 ],12155 "beta_header": null,12156 "status": [12157 "DOCUMENTED"12158 ],12159 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12160 "variant": "custom_tool_call",12161 "schema_ref": "CustomToolCall"12162 },12163 {12164 "provider": "openai",12165 "endpoint": "POST /v1/conversations/{conversation_id}/items",12166 "parameter": "items[](custom_tool_call).type",12167 "location": "body",12168 "type": "string",12169 "required": true,12170 "default": null,12171 "minimum": null,12172 "maximum": null,12173 "enum": [12174 "custom_tool_call"12175 ],12176 "description": "The type of the custom tool call. Always `custom_tool_call`.",12177 "compatible_models": [12178 "*"12179 ],12180 "beta_header": null,12181 "status": [12182 "DOCUMENTED"12183 ],12184 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12185 },12186 {12187 "provider": "openai",12188 "endpoint": "POST /v1/conversations/{conversation_id}/items",12189 "parameter": "items[](custom_tool_call).id",12190 "location": "body",12191 "type": "string",12192 "required": false,12193 "default": null,12194 "minimum": null,12195 "maximum": null,12196 "enum": null,12197 "description": "The unique ID of the custom tool call in the OpenAI platform.",12198 "compatible_models": [12199 "*"12200 ],12201 "beta_header": null,12202 "status": [12203 "DOCUMENTED"12204 ],12205 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12206 },12207 {12208 "provider": "openai",12209 "endpoint": "POST /v1/conversations/{conversation_id}/items",12210 "parameter": "items[](custom_tool_call).call_id",12211 "location": "body",12212 "type": "string",12213 "required": true,12214 "default": null,12215 "minimum": null,12216 "maximum": null,12217 "enum": null,12218 "description": "An identifier used to map this custom tool call to a tool call output.",12219 "compatible_models": [12220 "*"12221 ],12222 "beta_header": null,12223 "status": [12224 "DOCUMENTED"12225 ],12226 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12227 },12228 {12229 "provider": "openai",12230 "endpoint": "POST /v1/conversations/{conversation_id}/items",12231 "parameter": "items[](custom_tool_call).caller",12232 "location": "body",12233 "type": "object<direct> | object<program>",12234 "required": false,12235 "default": null,12236 "minimum": null,12237 "maximum": null,12238 "enum": null,12239 "description": "The execution context that produced this tool call.",12240 "compatible_models": [12241 "*"12242 ],12243 "beta_header": null,12244 "status": [12245 "DOCUMENTED"12246 ],12247 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12248 "nullable": true12249 },12250 {12251 "provider": "openai",12252 "endpoint": "POST /v1/conversations/{conversation_id}/items",12253 "parameter": "items[](custom_tool_call).caller(direct)",12254 "location": "body",12255 "type": "object",12256 "required": false,12257 "default": null,12258 "minimum": null,12259 "maximum": null,12260 "enum": null,12261 "description": "",12262 "compatible_models": [12263 "*"12264 ],12265 "beta_header": null,12266 "status": [12267 "DOCUMENTED"12268 ],12269 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12270 "variant": "direct",12271 "schema_ref": "DirectToolCallCaller"12272 },12273 {12274 "provider": "openai",12275 "endpoint": "POST /v1/conversations/{conversation_id}/items",12276 "parameter": "items[](custom_tool_call).caller(program)",12277 "location": "body",12278 "type": "object",12279 "required": false,12280 "default": null,12281 "minimum": null,12282 "maximum": null,12283 "enum": null,12284 "description": "",12285 "compatible_models": [12286 "*"12287 ],12288 "beta_header": null,12289 "status": [12290 "DOCUMENTED"12291 ],12292 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12293 "variant": "program",12294 "schema_ref": "ProgramToolCallCaller"12295 },12296 {12297 "provider": "openai",12298 "endpoint": "POST /v1/conversations/{conversation_id}/items",12299 "parameter": "items[](custom_tool_call).namespace",12300 "location": "body",12301 "type": "string",12302 "required": false,12303 "default": null,12304 "minimum": null,12305 "maximum": null,12306 "enum": null,12307 "description": "The namespace of the custom tool being called.",12308 "compatible_models": [12309 "*"12310 ],12311 "beta_header": null,12312 "status": [12313 "DOCUMENTED"12314 ],12315 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12316 },12317 {12318 "provider": "openai",12319 "endpoint": "POST /v1/conversations/{conversation_id}/items",12320 "parameter": "items[](custom_tool_call).name",12321 "location": "body",12322 "type": "string",12323 "required": true,12324 "default": null,12325 "minimum": null,12326 "maximum": null,12327 "enum": null,12328 "description": "The name of the custom tool being called.",12329 "compatible_models": [12330 "*"12331 ],12332 "beta_header": null,12333 "status": [12334 "DOCUMENTED"12335 ],12336 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12337 },12338 {12339 "provider": "openai",12340 "endpoint": "POST /v1/conversations/{conversation_id}/items",12341 "parameter": "items[](custom_tool_call).input",12342 "location": "body",12343 "type": "string",12344 "required": true,12345 "default": null,12346 "minimum": null,12347 "maximum": null,12348 "enum": null,12349 "description": "The input for the custom tool call generated by the model.",12350 "compatible_models": [12351 "*"12352 ],12353 "beta_header": null,12354 "status": [12355 "DOCUMENTED"12356 ],12357 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12358 },12359 {12360 "provider": "openai",12361 "endpoint": "POST /v1/conversations/{conversation_id}/items",12362 "parameter": "items[](custom_tool_call).async",12363 "location": "body",12364 "type": "boolean",12365 "required": false,12366 "default": null,12367 "minimum": null,12368 "maximum": null,12369 "enum": null,12370 "description": "Whether the custom tool call runs asynchronously.",12371 "compatible_models": [12372 "*"12373 ],12374 "beta_header": null,12375 "status": [12376 "DOCUMENTED"12377 ],12378 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12379 },12380 {12381 "provider": "openai",12382 "endpoint": "POST /v1/conversations/{conversation_id}/items",12383 "parameter": "items[](compaction_trigger)",12384 "location": "body",12385 "type": "object",12386 "required": false,12387 "default": null,12388 "minimum": null,12389 "maximum": null,12390 "enum": null,12391 "description": "Compacts the current context. Must be the final input item.",12392 "compatible_models": [12393 "*"12394 ],12395 "beta_header": null,12396 "status": [12397 "DOCUMENTED"12398 ],12399 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12400 "variant": "compaction_trigger",12401 "schema_ref": "CompactionTriggerItemParam"12402 },12403 {12404 "provider": "openai",12405 "endpoint": "POST /v1/conversations/{conversation_id}/items",12406 "parameter": "items[](compaction_trigger).id",12407 "location": "body",12408 "type": "string | null",12409 "required": false,12410 "default": null,12411 "minimum": null,12412 "maximum": null,12413 "enum": null,12414 "description": "The unique ID of this compaction trigger.",12415 "compatible_models": [12416 "*"12417 ],12418 "beta_header": null,12419 "status": [12420 "DOCUMENTED"12421 ],12422 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12423 "nullable": true12424 },12425 {12426 "provider": "openai",12427 "endpoint": "POST /v1/conversations/{conversation_id}/items",12428 "parameter": "items[](compaction_trigger).type",12429 "location": "body",12430 "type": "string",12431 "required": true,12432 "default": "compaction_trigger",12433 "minimum": null,12434 "maximum": null,12435 "enum": [12436 "compaction_trigger"12437 ],12438 "description": "The type of the item. Always `compaction_trigger`.",12439 "compatible_models": [12440 "*"12441 ],12442 "beta_header": null,12443 "status": [12444 "DOCUMENTED"12445 ],12446 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12447 },12448 {12449 "provider": "openai",12450 "endpoint": "POST /v1/conversations/{conversation_id}/items",12451 "parameter": "items[](item_reference)",12452 "location": "body",12453 "type": "object",12454 "required": false,12455 "default": null,12456 "minimum": null,12457 "maximum": null,12458 "enum": null,12459 "description": "An internal identifier for an item to reference.",12460 "compatible_models": [12461 "*"12462 ],12463 "beta_header": null,12464 "status": [12465 "DOCUMENTED"12466 ],12467 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12468 "variant": "ItemReferenceParam",12469 "schema_ref": "ItemReferenceParam"12470 },12471 {12472 "provider": "openai",12473 "endpoint": "POST /v1/conversations/{conversation_id}/items",12474 "parameter": "items[](item_reference).type",12475 "location": "body",12476 "type": "string | null",12477 "required": false,12478 "default": "item_reference",12479 "minimum": null,12480 "maximum": null,12481 "enum": [12482 "item_reference"12483 ],12484 "description": "The type of item to reference. Always `item_reference`.",12485 "compatible_models": [12486 "*"12487 ],12488 "beta_header": null,12489 "status": [12490 "DOCUMENTED"12491 ],12492 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12493 "nullable": true12494 },12495 {12496 "provider": "openai",12497 "endpoint": "POST /v1/conversations/{conversation_id}/items",12498 "parameter": "items[](item_reference).id",12499 "location": "body",12500 "type": "string",12501 "required": true,12502 "default": null,12503 "minimum": null,12504 "maximum": null,12505 "enum": null,12506 "description": "The ID of the item to reference.",12507 "compatible_models": [12508 "*"12509 ],12510 "beta_header": null,12511 "status": [12512 "DOCUMENTED"12513 ],12514 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12515 },12516 {12517 "provider": "openai",12518 "endpoint": "POST /v1/conversations/{conversation_id}/items",12519 "parameter": "items[](program)",12520 "location": "body",12521 "type": "object",12522 "required": false,12523 "default": null,12524 "minimum": null,12525 "maximum": null,12526 "enum": null,12527 "description": "",12528 "compatible_models": [12529 "*"12530 ],12531 "beta_header": null,12532 "status": [12533 "DOCUMENTED"12534 ],12535 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12536 "variant": "program",12537 "schema_ref": "ProgramItemParam"12538 },12539 {12540 "provider": "openai",12541 "endpoint": "POST /v1/conversations/{conversation_id}/items",12542 "parameter": "items[](program).id",12543 "location": "body",12544 "type": "string",12545 "required": true,12546 "default": null,12547 "minimum": null,12548 "maximum": null,12549 "enum": null,12550 "description": "The unique ID of this program item.",12551 "compatible_models": [12552 "*"12553 ],12554 "beta_header": null,12555 "status": [12556 "DOCUMENTED"12557 ],12558 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12559 },12560 {12561 "provider": "openai",12562 "endpoint": "POST /v1/conversations/{conversation_id}/items",12563 "parameter": "items[](program).type",12564 "location": "body",12565 "type": "string",12566 "required": true,12567 "default": "program",12568 "minimum": null,12569 "maximum": null,12570 "enum": [12571 "program"12572 ],12573 "description": "The item type. Always `program`.",12574 "compatible_models": [12575 "*"12576 ],12577 "beta_header": null,12578 "status": [12579 "DOCUMENTED"12580 ],12581 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12582 },12583 {12584 "provider": "openai",12585 "endpoint": "POST /v1/conversations/{conversation_id}/items",12586 "parameter": "items[](program).call_id",12587 "location": "body",12588 "type": "string",12589 "required": true,12590 "default": null,12591 "minimum": null,12592 "maximum": null,12593 "enum": null,12594 "description": "The stable call ID of the program item.",12595 "compatible_models": [12596 "*"12597 ],12598 "beta_header": null,12599 "status": [12600 "DOCUMENTED"12601 ],12602 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12603 },12604 {12605 "provider": "openai",12606 "endpoint": "POST /v1/conversations/{conversation_id}/items",12607 "parameter": "items[](program).code",12608 "location": "body",12609 "type": "string",12610 "required": true,12611 "default": null,12612 "minimum": null,12613 "maximum": null,12614 "enum": null,12615 "description": "The JavaScript source executed by programmatic tool calling.",12616 "compatible_models": [12617 "*"12618 ],12619 "beta_header": null,12620 "status": [12621 "DOCUMENTED"12622 ],12623 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12624 },12625 {12626 "provider": "openai",12627 "endpoint": "POST /v1/conversations/{conversation_id}/items",12628 "parameter": "items[](program).fingerprint",12629 "location": "body",12630 "type": "string",12631 "required": true,12632 "default": null,12633 "minimum": null,12634 "maximum": null,12635 "enum": null,12636 "description": "Opaque program replay fingerprint that must be round-tripped.",12637 "compatible_models": [12638 "*"12639 ],12640 "beta_header": null,12641 "status": [12642 "DOCUMENTED"12643 ],12644 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12645 },12646 {12647 "provider": "openai",12648 "endpoint": "POST /v1/conversations/{conversation_id}/items",12649 "parameter": "items[](program_output)",12650 "location": "body",12651 "type": "object",12652 "required": false,12653 "default": null,12654 "minimum": null,12655 "maximum": null,12656 "enum": null,12657 "description": "",12658 "compatible_models": [12659 "*"12660 ],12661 "beta_header": null,12662 "status": [12663 "DOCUMENTED"12664 ],12665 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12666 "variant": "program_output",12667 "schema_ref": "ProgramOutputItemParam"12668 },12669 {12670 "provider": "openai",12671 "endpoint": "POST /v1/conversations/{conversation_id}/items",12672 "parameter": "items[](program_output).id",12673 "location": "body",12674 "type": "string",12675 "required": true,12676 "default": null,12677 "minimum": null,12678 "maximum": null,12679 "enum": null,12680 "description": "The unique ID of this program output item.",12681 "compatible_models": [12682 "*"12683 ],12684 "beta_header": null,12685 "status": [12686 "DOCUMENTED"12687 ],12688 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12689 },12690 {12691 "provider": "openai",12692 "endpoint": "POST /v1/conversations/{conversation_id}/items",12693 "parameter": "items[](program_output).type",12694 "location": "body",12695 "type": "string",12696 "required": true,12697 "default": "program_output",12698 "minimum": null,12699 "maximum": null,12700 "enum": [12701 "program_output"12702 ],12703 "description": "The item type. Always `program_output`.",12704 "compatible_models": [12705 "*"12706 ],12707 "beta_header": null,12708 "status": [12709 "DOCUMENTED"12710 ],12711 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12712 },12713 {12714 "provider": "openai",12715 "endpoint": "POST /v1/conversations/{conversation_id}/items",12716 "parameter": "items[](program_output).call_id",12717 "location": "body",12718 "type": "string",12719 "required": true,12720 "default": null,12721 "minimum": null,12722 "maximum": null,12723 "enum": null,12724 "description": "The call ID of the program item.",12725 "compatible_models": [12726 "*"12727 ],12728 "beta_header": null,12729 "status": [12730 "DOCUMENTED"12731 ],12732 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12733 },12734 {12735 "provider": "openai",12736 "endpoint": "POST /v1/conversations/{conversation_id}/items",12737 "parameter": "items[](program_output).result",12738 "location": "body",12739 "type": "string",12740 "required": true,12741 "default": null,12742 "minimum": null,12743 "maximum": null,12744 "enum": null,12745 "description": "The result produced by the program item.",12746 "compatible_models": [12747 "*"12748 ],12749 "beta_header": null,12750 "status": [12751 "DOCUMENTED"12752 ],12753 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12754 },12755 {12756 "provider": "openai",12757 "endpoint": "POST /v1/conversations/{conversation_id}/items",12758 "parameter": "items[](program_output).status",12759 "location": "body",12760 "type": "string",12761 "required": true,12762 "default": null,12763 "minimum": null,12764 "maximum": null,12765 "enum": [12766 "completed",12767 "incomplete"12768 ],12769 "description": "The terminal status of the program output.",12770 "compatible_models": [12771 "*"12772 ],12773 "beta_header": null,12774 "status": [12775 "DOCUMENTED"12776 ],12777 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12778 "schema_ref": "ProgramOutputItemStatus"12779 },12780 {12781 "provider": "openai",12782 "endpoint": "POST /v1/conversations/{conversation_id}/items",12783 "parameter": "items[](message).content[](input_text)",12784 "location": "body",12785 "type": "object",12786 "required": false,12787 "default": null,12788 "minimum": null,12789 "maximum": null,12790 "enum": null,12791 "description": "A text input to the model.",12792 "compatible_models": [12793 "*"12794 ],12795 "beta_header": null,12796 "status": [12797 "DOCUMENTED",12798 "LIVE_VERIFIED"12799 ],12800 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12801 "variant": "input_text",12802 "schema_ref": "InputTextContent"12803 },12804 {12805 "provider": "openai",12806 "endpoint": "POST /v1/conversations/{conversation_id}/items",12807 "parameter": "items[](message).content[](input_text).type",12808 "location": "body",12809 "type": "string",12810 "required": true,12811 "default": "input_text",12812 "minimum": null,12813 "maximum": null,12814 "enum": [12815 "input_text"12816 ],12817 "description": "The type of the input item. Always `input_text`.",12818 "compatible_models": [12819 "*"12820 ],12821 "beta_header": null,12822 "status": [12823 "DOCUMENTED",12824 "LIVE_VERIFIED"12825 ],12826 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12827 },12828 {12829 "provider": "openai",12830 "endpoint": "POST /v1/conversations/{conversation_id}/items",12831 "parameter": "items[](message).content[](input_text).text",12832 "location": "body",12833 "type": "string",12834 "required": true,12835 "default": null,12836 "minimum": null,12837 "maximum": null,12838 "enum": null,12839 "description": "The text input to the model.",12840 "compatible_models": [12841 "*"12842 ],12843 "beta_header": null,12844 "status": [12845 "DOCUMENTED",12846 "LIVE_VERIFIED"12847 ],12848 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12849 },12850 {12851 "provider": "openai",12852 "endpoint": "POST /v1/conversations/{conversation_id}/items",12853 "parameter": "items[](message).content[](input_text).prompt_cache_breakpoint",12854 "location": "body",12855 "type": "object",12856 "required": false,12857 "default": null,12858 "minimum": null,12859 "maximum": null,12860 "enum": null,12861 "description": "Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.",12862 "compatible_models": [12863 "*"12864 ],12865 "beta_header": null,12866 "status": [12867 "DOCUMENTED"12868 ],12869 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12870 "schema_ref": "PromptCacheBreakpointConfig"12871 },12872 {12873 "provider": "openai",12874 "endpoint": "POST /v1/conversations/{conversation_id}/items",12875 "parameter": "items[](message).content[](input_text).prompt_cache_breakpoint.mode",12876 "location": "body",12877 "type": "string",12878 "required": true,12879 "default": "explicit",12880 "minimum": null,12881 "maximum": null,12882 "enum": [12883 "explicit"12884 ],12885 "description": "The breakpoint mode. Always `explicit`.",12886 "compatible_models": [12887 "*"12888 ],12889 "beta_header": null,12890 "status": [12891 "DOCUMENTED"12892 ],12893 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12894 },12895 {12896 "provider": "openai",12897 "endpoint": "POST /v1/conversations/{conversation_id}/items",12898 "parameter": "items[](message).content[](input_image)",12899 "location": "body",12900 "type": "object",12901 "required": false,12902 "default": null,12903 "minimum": null,12904 "maximum": null,12905 "enum": null,12906 "description": "An image input to the model. Learn about [image inputs](https://developers.openai.com/api/docs/guides/images-vision).",12907 "compatible_models": [12908 "*"12909 ],12910 "beta_header": null,12911 "status": [12912 "DOCUMENTED"12913 ],12914 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12915 "variant": "input_image",12916 "schema_ref": "InputImageContent"12917 },12918 {12919 "provider": "openai",12920 "endpoint": "POST /v1/conversations/{conversation_id}/items",12921 "parameter": "items[](message).content[](input_image).type",12922 "location": "body",12923 "type": "string",12924 "required": true,12925 "default": "input_image",12926 "minimum": null,12927 "maximum": null,12928 "enum": [12929 "input_image"12930 ],12931 "description": "The type of the input item. Always `input_image`.",12932 "compatible_models": [12933 "*"12934 ],12935 "beta_header": null,12936 "status": [12937 "DOCUMENTED"12938 ],12939 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"12940 },12941 {12942 "provider": "openai",12943 "endpoint": "POST /v1/conversations/{conversation_id}/items",12944 "parameter": "items[](message).content[](input_image).image_url",12945 "location": "body",12946 "type": "string | null",12947 "required": false,12948 "default": null,12949 "minimum": null,12950 "maximum": null,12951 "enum": null,12952 "description": "The URL of the image to be sent to the model. A fully qualified URL or base64 encoded image in a data URL.",12953 "compatible_models": [12954 "*"12955 ],12956 "beta_header": null,12957 "status": [12958 "DOCUMENTED"12959 ],12960 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12961 "nullable": true12962 },12963 {12964 "provider": "openai",12965 "endpoint": "POST /v1/conversations/{conversation_id}/items",12966 "parameter": "items[](message).content[](input_image).file_id",12967 "location": "body",12968 "type": "string | null",12969 "required": false,12970 "default": null,12971 "minimum": null,12972 "maximum": null,12973 "enum": null,12974 "description": "The ID of the file to be sent to the model.",12975 "compatible_models": [12976 "*"12977 ],12978 "beta_header": null,12979 "status": [12980 "DOCUMENTED"12981 ],12982 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",12983 "nullable": true12984 },12985 {12986 "provider": "openai",12987 "endpoint": "POST /v1/conversations/{conversation_id}/items",12988 "parameter": "items[](message).content[](input_image).detail",12989 "location": "body",12990 "type": "string",12991 "required": true,12992 "default": null,12993 "minimum": null,12994 "maximum": null,12995 "enum": [12996 "low",12997 "high",12998 "auto",12999 "original"13000 ],13001 "description": "The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or `original`. Defaults to `auto`.",13002 "compatible_models": [13003 "*"13004 ],13005 "beta_header": null,13006 "status": [13007 "DOCUMENTED"13008 ],13009 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",13010 "schema_ref": "ImageDetail"13011 },13012 {13013 "provider": "openai",13014 "endpoint": "POST /v1/conversations/{conversation_id}/items",13015 "parameter": "items[](message).content[](input_image).prompt_cache_breakpoint",13016 "location": "body",13017 "type": "object",13018 "required": false,13019 "default": null,13020 "minimum": null,13021 "maximum": null,13022 "enum": null,13023 "description": "Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.",13024 "compatible_models": [13025 "*"13026 ],13027 "beta_header": null,13028 "status": [13029 "DOCUMENTED"13030 ],13031 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",13032 "schema_ref": "PromptCacheBreakpointConfig"13033 },13034 {13035 "provider": "openai",13036 "endpoint": "POST /v1/conversations/{conversation_id}/items",13037 "parameter": "items[](message).content[](input_image).prompt_cache_breakpoint.mode",13038 "location": "body",13039 "type": "string",13040 "required": true,13041 "default": "explicit",13042 "minimum": null,13043 "maximum": null,13044 "enum": [13045 "explicit"13046 ],13047 "description": "The breakpoint mode. Always `explicit`.",13048 "compatible_models": [13049 "*"13050 ],13051 "beta_header": null,13052 "status": [13053 "DOCUMENTED"13054 ],13055 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"13056 },13057 {13058 "provider": "openai",13059 "endpoint": "POST /v1/conversations/{conversation_id}/items",13060 "parameter": "items[](message).content[](input_file)",13061 "location": "body",13062 "type": "object",13063 "required": false,13064 "default": null,13065 "minimum": null,13066 "maximum": null,13067 "enum": null,13068 "description": "A file input to the model.",13069 "compatible_models": [13070 "*"13071 ],13072 "beta_header": null,13073 "status": [13074 "DOCUMENTED"13075 ],13076 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",13077 "variant": "input_file",13078 "schema_ref": "InputFileContent"13079 },13080 {13081 "provider": "openai",13082 "endpoint": "POST /v1/conversations/{conversation_id}/items",13083 "parameter": "items[](message).content[](input_file).type",13084 "location": "body",13085 "type": "string",13086 "required": true,13087 "default": "input_file",13088 "minimum": null,13089 "maximum": null,13090 "enum": [13091 "input_file"13092 ],13093 "description": "The type of the input item. Always `input_file`.",13094 "compatible_models": [13095 "*"13096 ],13097 "beta_header": null,13098 "status": [13099 "DOCUMENTED"13100 ],13101 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"13102 },13103 {13104 "provider": "openai",13105 "endpoint": "POST /v1/conversations/{conversation_id}/items",13106 "parameter": "items[](message).content[](input_file).file_id",13107 "location": "body",13108 "type": "string | null",13109 "required": false,13110 "default": null,13111 "minimum": null,13112 "maximum": null,13113 "enum": null,13114 "description": "The ID of the file to be sent to the model.",13115 "compatible_models": [13116 "*"13117 ],13118 "beta_header": null,13119 "status": [13120 "DOCUMENTED"13121 ],13122 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",13123 "nullable": true13124 },13125 {13126 "provider": "openai",13127 "endpoint": "POST /v1/conversations/{conversation_id}/items",13128 "parameter": "items[](message).content[](input_file).filename",13129 "location": "body",13130 "type": "string",13131 "required": false,13132 "default": null,13133 "minimum": null,13134 "maximum": null,13135 "enum": null,13136 "description": "The name of the file to be sent to the model.",13137 "compatible_models": [13138 "*"13139 ],13140 "beta_header": null,13141 "status": [13142 "DOCUMENTED"13143 ],13144 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"13145 },13146 {13147 "provider": "openai",13148 "endpoint": "POST /v1/conversations/{conversation_id}/items",13149 "parameter": "items[](message).content[](input_file).file_data",13150 "location": "body",13151 "type": "string",13152 "required": false,13153 "default": null,13154 "minimum": null,13155 "maximum": null,13156 "enum": null,13157 "description": "The content of the file to be sent to the model.",13158 "compatible_models": [13159 "*"13160 ],13161 "beta_header": null,13162 "status": [13163 "DOCUMENTED"13164 ],13165 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"13166 },13167 {13168 "provider": "openai",13169 "endpoint": "POST /v1/conversations/{conversation_id}/items",13170 "parameter": "items[](message).content[](input_file).prompt_cache_breakpoint",13171 "location": "body",13172 "type": "object",13173 "required": false,13174 "default": null,13175 "minimum": null,13176 "maximum": null,13177 "enum": null,13178 "description": "Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.",13179 "compatible_models": [13180 "*"13181 ],13182 "beta_header": null,13183 "status": [13184 "DOCUMENTED"13185 ],13186 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",13187 "schema_ref": "PromptCacheBreakpointConfig"13188 },13189 {13190 "provider": "openai",13191 "endpoint": "POST /v1/conversations/{conversation_id}/items",13192 "parameter": "items[](message).content[](input_file).prompt_cache_breakpoint.mode",13193 "location": "body",13194 "type": "string",13195 "required": true,13196 "default": "explicit",13197 "minimum": null,13198 "maximum": null,13199 "enum": [13200 "explicit"13201 ],13202 "description": "The breakpoint mode. Always `explicit`.",13203 "compatible_models": [13204 "*"13205 ],13206 "beta_header": null,13207 "status": [13208 "DOCUMENTED"13209 ],13210 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"13211 },13212 {13213 "provider": "openai",13214 "endpoint": "POST /v1/conversations/{conversation_id}/items",13215 "parameter": "items[](message).content[](input_file).file_url",13216 "location": "body",13217 "type": "string",13218 "required": false,13219 "default": null,13220 "minimum": null,13221 "maximum": null,13222 "enum": null,13223 "description": "The URL of the file to be sent to the model.",13224 "compatible_models": [13225 "*"13226 ],13227 "beta_header": null,13228 "status": [13229 "DOCUMENTED"13230 ],13231 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"13232 },13233 {13234 "provider": "openai",13235 "endpoint": "POST /v1/conversations/{conversation_id}/items",13236 "parameter": "items[](message).content[](input_file).detail",13237 "location": "body",13238 "type": "string",13239 "required": false,13240 "default": null,13241 "minimum": null,13242 "maximum": null,13243 "enum": [13244 "auto",13245 "low",13246 "high"13247 ],13248 "description": "The detail level of the file to be sent to the model. Use `auto` to let the system select the detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which may increase input token usage. Use `low` for lower-cost rendering, or `high` to render the file at higher quality. Defaults to `auto`.",13249 "compatible_models": [13250 "*"13251 ],13252 "beta_header": null,13253 "status": [13254 "DOCUMENTED"13255 ],13256 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create",13257 "schema_ref": "FileInputDetail"13258 },13259 {13260 "provider": "openai",13261 "endpoint": "POST /v1/conversations/{conversation_id}",13262 "parameter": "metadata",13263 "location": "body",13264 "type": "map<string,string>",13265 "required": true,13266 "default": null,13267 "minimum": null,13268 "maximum": null,13269 "enum": null,13270 "description": "Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.",13271 "compatible_models": [13272 "*"13273 ],13274 "beta_header": null,13275 "status": [13276 "DOCUMENTED",13277 "LIVE_VERIFIED"13278 ],13279 "source": "https://developers.openai.com/api/reference/resources/conversations/methods/update",13280 "nullable": true,13281 "schema_ref": "Metadata"13282 },13283 {13284 "provider": "openai",13285 "endpoint": "GET /v1/conversations/{conversation_id}/items",13286 "parameter": "limit",13287 "location": "query",13288 "type": "integer",13289 "required": false,13290 "default": 20,13291 "minimum": null,13292 "maximum": null,13293 "enum": null,13294 "description": "A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.",13295 "compatible_models": [13296 "*"13297 ],13298 "beta_header": null,13299 "status": [13300 "DOCUMENTED",13301 "LIVE_VERIFIED"13302 ],13303 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/list"13304 },13305 {13306 "provider": "openai",13307 "endpoint": "GET /v1/conversations/{conversation_id}/items",13308 "parameter": "order",13309 "location": "query",13310 "type": "string",13311 "required": false,13312 "default": null,13313 "minimum": null,13314 "maximum": null,13315 "enum": [13316 "asc",13317 "desc"13318 ],13319 "description": "The order to return the input items in. Default is `desc`. - `asc`: Return the input items in ascending order. - `desc`: Return the input items in descending order.",13320 "compatible_models": [13321 "*"13322 ],13323 "beta_header": null,13324 "status": [13325 "DOCUMENTED",13326 "LIVE_VERIFIED"13327 ],13328 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/list"13329 },13330 {13331 "provider": "openai",13332 "endpoint": "GET /v1/conversations/{conversation_id}/items",13333 "parameter": "after",13334 "location": "query",13335 "type": "string",13336 "required": false,13337 "default": null,13338 "minimum": null,13339 "maximum": null,13340 "enum": null,13341 "description": "An item ID to list items after, used in pagination.",13342 "compatible_models": [13343 "*"13344 ],13345 "beta_header": null,13346 "status": [13347 "DOCUMENTED"13348 ],13349 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/list"13350 },13351 {13352 "provider": "openai",13353 "endpoint": "GET /v1/conversations/{conversation_id}/items",13354 "parameter": "include",13355 "location": "query",13356 "type": "array<string>",13357 "required": false,13358 "default": null,13359 "minimum": null,13360 "maximum": null,13361 "enum": null,13362 "description": "Specify additional output data to include in the model response. Currently supported values are: - `web_search_call.action.sources`: Include the sources of the web search tool call. - `code_interpreter_call.outputs`: Includes the outputs of python code execution in code interpreter tool call items. - `computer_call_output.output.image_url`: Include image urls from the computer call output. - `file_search_call.results`: Include the search results of the file search tool call. - `message.input_image.image_url`: Include image urls from the input message. - `message.output_text.logprobs`: Include logprobs with assistant messages. - `reasoning.encrypted_content`: Includes an encrypted version of reasoning tokens in reasoning item outputs. This enables reasoning items to be used in multi-turn conversations when using the Responses API statelessly (like when the `store` parameter is set to `fal",13363 "compatible_models": [13364 "*"13365 ],13366 "beta_header": null,13367 "status": [13368 "DOCUMENTED"13369 ],13370 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/list"13371 },13372 {13373 "provider": "openai",13374 "endpoint": "POST /v1/conversations/{conversation_id}/items",13375 "parameter": "include",13376 "location": "query",13377 "type": "array<string>",13378 "required": false,13379 "default": null,13380 "minimum": null,13381 "maximum": null,13382 "enum": null,13383 "description": "Additional fields to include in the response. See the `include` parameter for [listing Conversation items above](https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/list#%28resource%29%20conversations.items%20%3E%20%28method%29%20list%20%3E%20%28params%29%20default%20%3E%20%28param%29%20include%20%3E%20%28schema%29) for more information.",13384 "compatible_models": [13385 "*"13386 ],13387 "beta_header": null,13388 "status": [13389 "DOCUMENTED"13390 ],13391 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/create"13392 },13393 {13394 "provider": "openai",13395 "endpoint": "GET /v1/conversations/{conversation_id}/items/{item_id}",13396 "parameter": "include",13397 "location": "query",13398 "type": "array<string>",13399 "required": false,13400 "default": null,13401 "minimum": null,13402 "maximum": null,13403 "enum": null,13404 "description": "Additional fields to include in the response. See the `include` parameter for [listing Conversation items above](https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/list#%28resource%29%20conversations.items%20%3E%20%28method%29%20list%20%3E%20%28params%29%20default%20%3E%20%28param%29%20include%20%3E%20%28schema%29) for more information.",13405 "compatible_models": [13406 "*"13407 ],13408 "beta_header": null,13409 "status": [13410 "DOCUMENTED"13411 ],13412 "source": "https://developers.openai.com/api/reference/resources/conversations/subresources/items/methods/retrieve"13413 }13414 ]13415}