release: 2.26.0 (#2932)

* feat(api): The GA ComputerTool now uses the CompuerTool class. The 'computer_use_preview' tool is moved to ComputerUsePreview

This fixes naming of the old computer_use_preview, which previously took the ComputerTool name. There is a newly GAed `computer` tool now available, which will use the ComputerTool name.

This may be a breaking change for users of the preview tool.

* release: 2.26.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "2.25.0"
+  ".": "2.26.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 148
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-9c802d45a9bf2a896b5fd22ac22bba185e8a145bd40ed242df9bb87a05e954eb.yml
 openapi_spec_hash: 97984ed69285e660b7d5c810c69ed449
-config_hash: acb0b1eb5d7284bfedaddb29f7f5a691
+config_hash: 8240b8a7a7fc145a45b93bda435612d6

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2.26.0 (2026-03-05)
+
+Full Changelog: [v2.25.0...v2.26.0](https://github.com/openai/openai-python/compare/v2.25.0...v2.26.0)
+
+### Features
+
+* **api:** The GA ComputerTool now uses the CompuerTool class. The 'computer_use_preview' tool is moved to ComputerUsePreview ([78f5b3c](https://github.com/openai/openai-python/commit/78f5b3c287b71ed6fbeb71fb6b5c0366db704cd2))
+
 ## 2.25.0 (2026-03-05)
 
 Full Changelog: [v2.24.0...v2.25.0](https://github.com/openai/openai-python/compare/v2.24.0...v2.25.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openai"
-version = "2.25.0"
+version = "2.26.0"
 description = "The official Python library for the openai API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/openai/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "openai"
-__version__ = "2.25.0"  # x-release-please-version
+__version__ = "2.26.0"  # x-release-please-version

src/openai/resources/responses/api.md

@@ -9,7 +9,7 @@ from openai.types.responses import (
     ComputerAction,
     ComputerActionList,
     ComputerTool,
-    ComputerUseTool,
+    ComputerUsePreviewTool,
     ContainerAuto,
     ContainerNetworkPolicyAllowlist,
     ContainerNetworkPolicyDisabled,

src/openai/types/responses/__init__.py

@@ -33,7 +33,6 @@
 from .apply_patch_tool import ApplyPatchTool as ApplyPatchTool
 from .file_search_tool import FileSearchTool as FileSearchTool
 from .tool_search_tool import ToolSearchTool as ToolSearchTool
-from .computer_use_tool import ComputerUseTool as ComputerUseTool
 from .custom_tool_param import CustomToolParam as CustomToolParam
 from .local_environment import LocalEnvironment as LocalEnvironment
 from .local_skill_param import LocalSkillParam as LocalSkillParam
@@ -83,7 +82,6 @@
 from .responses_client_event import ResponsesClientEvent as ResponsesClientEvent
 from .responses_server_event import ResponsesServerEvent as ResponsesServerEvent
 from .tool_search_tool_param import ToolSearchToolParam as ToolSearchToolParam
-from .computer_use_tool_param import ComputerUseToolParam as ComputerUseToolParam
 from .local_environment_param import LocalEnvironmentParam as LocalEnvironmentParam
 from .response_compact_params import ResponseCompactParams as ResponseCompactParams
 from .response_output_message import ResponseOutputMessage as ResponseOutputMessage
@@ -100,6 +98,7 @@
 from .response_retrieve_params import ResponseRetrieveParams as ResponseRetrieveParams
 from .response_text_done_event import ResponseTextDoneEvent as ResponseTextDoneEvent
 from .tool_choice_custom_param import ToolChoiceCustomParam as ToolChoiceCustomParam
+from .computer_use_preview_tool import ComputerUsePreviewTool as ComputerUsePreviewTool
 from .container_reference_param import ContainerReferenceParam as ContainerReferenceParam
 from .function_shell_tool_param import FunctionShellToolParam as FunctionShellToolParam
 from .inline_skill_source_param import InlineSkillSourceParam as InlineSkillSourceParam
@@ -145,6 +144,7 @@
 from .response_compaction_item_param import ResponseCompactionItemParam as ResponseCompactionItemParam
 from .response_file_search_tool_call import ResponseFileSearchToolCall as ResponseFileSearchToolCall
 from .response_mcp_call_failed_event import ResponseMcpCallFailedEvent as ResponseMcpCallFailedEvent
+from .computer_use_preview_tool_param import ComputerUsePreviewToolParam as ComputerUsePreviewToolParam
 from .response_custom_tool_call_param import ResponseCustomToolCallParam as ResponseCustomToolCallParam
 from .response_output_item_done_event import ResponseOutputItemDoneEvent as ResponseOutputItemDoneEvent
 from .response_content_part_done_event import ResponseContentPartDoneEvent as ResponseContentPartDoneEvent

src/openai/types/responses/computer_tool.py

@@ -13,14 +13,5 @@ class ComputerTool(BaseModel):
     Learn more about the [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
     """
 
-    display_height: int
-    """The height of the computer display."""
-
-    display_width: int
-    """The width of the computer display."""
-
-    environment: Literal["windows", "mac", "linux", "ubuntu", "browser"]
-    """The type of computer environment to control."""
-
-    type: Literal["computer_use_preview"]
-    """The type of the computer use tool. Always `computer_use_preview`."""
+    type: Literal["computer"]
+    """The type of the computer tool. Always `computer`."""

src/openai/types/responses/computer_tool_param.py

@@ -13,14 +13,5 @@ class ComputerToolParam(TypedDict, total=False):
     Learn more about the [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
     """
 
-    display_height: Required[int]
-    """The height of the computer display."""
-
-    display_width: Required[int]
-    """The width of the computer display."""
-
-    environment: Required[Literal["windows", "mac", "linux", "ubuntu", "browser"]]
-    """The type of computer environment to control."""
-
-    type: Required[Literal["computer_use_preview"]]
-    """The type of the computer use tool. Always `computer_use_preview`."""
+    type: Required[Literal["computer"]]
+    """The type of the computer tool. Always `computer`."""

src/openai/types/responses/computer_use_preview_tool.py

@@ -0,0 +1,26 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["ComputerUsePreviewTool"]
+
+
+class ComputerUsePreviewTool(BaseModel):
+    """A tool that controls a virtual computer.
+
+    Learn more about the [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+    """
+
+    display_height: int
+    """The height of the computer display."""
+
+    display_width: int
+    """The width of the computer display."""
+
+    environment: Literal["windows", "mac", "linux", "ubuntu", "browser"]
+    """The type of computer environment to control."""
+
+    type: Literal["computer_use_preview"]
+    """The type of the computer use tool. Always `computer_use_preview`."""