openai 0.67.0 → 0.68.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8515f14709f0142aad5e774faec12a26fc11e331272d0ac766a6053a726be73
-  data.tar.gz: 4e8cf9a95543ec6b51b84440895bbd8ca54e3fb1255c86ef7c4fe58b4f86e397
+  metadata.gz: d5ff11b5e599c4ebd4c202e215b46f943356f3fc91dcf1ce7e3210b647bc3676
+  data.tar.gz: 3359efbf0d523d7e31f2153b012b993c30e8ed3617ff07e00ca5580bbc414c0c
 SHA512:
-  metadata.gz: bdf14268aceab421308306c1d8e05a093d686ce33b704310ea6578e75632b05668e0167c55d10013cf9095e4fb54839bcc134be5f961c1d9e9fb7efb077424e9
-  data.tar.gz: 7356e94789f4400d652554651a2255c7de88fb8d78c838db138eb8f88efdd056fcd0f62a9b223ba1a935142c77301e4b05214d8ca25c904b9c9f26361d3413e7
+  metadata.gz: db46f5c0c9f949924bdc8d39f53e0419bcf05c4fbd6ba60cd0b5619d692c25698a3b4611c0dd5058c8e96e270bf0c6a05806cd2ff6b0010dc494a6891588083b
+  data.tar.gz: 1323527f82c69f1f84a6143cd5af7514bbf4ed5626dfaedc8eae2a75107a60b19d0218da149d598a31eb6a3e9e5a9d3e6c9497f05e1c758d3513d8421de4852b

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.68.0 (2026-06-17)
+
+Full Changelog: [v0.67.0...v0.68.0](https://github.com/openai/openai-ruby/compare/v0.67.0...v0.68.0)
+
+### Features
+
+* **api:** update OpenAPI spec or Stainless config ([e127868](https://github.com/openai/openai-ruby/commit/e1278686c33b1981c7f4db0eb3c27f2cf2b155ac))
+
 ## 0.67.0 (2026-06-16)
 
 Full Changelog: [v0.66.1...v0.67.0](https://github.com/openai/openai-ruby/compare/v0.66.1...v0.67.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.67.0"
+gem "openai", "~> 0.68.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/models/realtime/realtime_response_create_mcp_tool.rb

@@ -34,8 +34,8 @@ module OpenAI
 
         # @!attribute connector_id
         #   Identifier for service connectors, like those available in ChatGPT. One of
-        #   `server_url` or `connector_id` must be provided. Learn more about service
-        #   connectors
+        #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+        #   service connectors
         #   [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
         #
         #   Currently supported `connector_id` values are:
@@ -80,13 +80,20 @@ module OpenAI
         optional :server_description, String
 
         # @!attribute server_url
-        #   The URL for the MCP server. One of `server_url` or `connector_id` must be
-        #   provided.
+        #   The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+        #   must be provided.
         #
         #   @return [String, nil]
         optional :server_url, String
 
-        # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
+        # @!attribute tunnel_id
+        #   The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+        #   `server_url`, `connector_id`, or `tunnel_id` must be provided.
+        #
+        #   @return [String, nil]
+        optional :tunnel_id, String
+
+        # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, tunnel_id: nil, type: :mcp)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool} for more details.
         #
@@ -110,7 +117,9 @@ module OpenAI
         #
         #   @param server_description [String] Optional description of the MCP server, used to provide more context.
         #
-        #   @param server_url [String] The URL for the MCP server. One of `server_url` or `connector_id` must be
+        #   @param server_url [String] The URL for the MCP server. One of `server_url`, `connector_id`, or
+        #
+        #   @param tunnel_id [String] The Secure MCP Tunnel ID to use instead of a direct server URL. One of
         #
         #   @param type [Symbol, :mcp] The type of the MCP tool. Always `mcp`.
 
@@ -162,8 +171,8 @@ module OpenAI
         end
 
         # Identifier for service connectors, like those available in ChatGPT. One of
-        # `server_url` or `connector_id` must be provided. Learn more about service
-        # connectors
+        # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+        # service connectors
         # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
         #
         # Currently supported `connector_id` values are:

data/lib/openai/models/realtime/realtime_session_create_response.rb

@@ -760,8 +760,8 @@ module OpenAI
 
             # @!attribute connector_id
             #   Identifier for service connectors, like those available in ChatGPT. One of
-            #   `server_url` or `connector_id` must be provided. Learn more about service
-            #   connectors
+            #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+            #   service connectors
             #   [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
             #
             #   Currently supported `connector_id` values are:
@@ -809,13 +809,20 @@ module OpenAI
             optional :server_description, String
 
             # @!attribute server_url
-            #   The URL for the MCP server. One of `server_url` or `connector_id` must be
-            #   provided.
+            #   The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+            #   must be provided.
             #
             #   @return [String, nil]
             optional :server_url, String
 
-            # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
+            # @!attribute tunnel_id
+            #   The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+            #   `server_url`, `connector_id`, or `tunnel_id` must be provided.
+            #
+            #   @return [String, nil]
+            optional :tunnel_id, String
+
+            # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, tunnel_id: nil, type: :mcp)
             #   Some parameter documentations has been truncated, see
             #   {OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Tool::McpTool} for
             #   more details.
@@ -840,7 +847,9 @@ module OpenAI
             #
             #   @param server_description [String] Optional description of the MCP server, used to provide more context.
             #
-            #   @param server_url [String] The URL for the MCP server. One of `server_url` or `connector_id` must be
+            #   @param server_url [String] The URL for the MCP server. One of `server_url`, `connector_id`, or
+            #
+            #   @param tunnel_id [String] The Secure MCP Tunnel ID to use instead of a direct server URL. One of
             #
             #   @param type [Symbol, :mcp] The type of the MCP tool. Always `mcp`.
 
@@ -892,8 +901,8 @@ module OpenAI
             end
 
             # Identifier for service connectors, like those available in ChatGPT. One of
-            # `server_url` or `connector_id` must be provided. Learn more about service
-            # connectors
+            # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+            # service connectors
             # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
             #
             # Currently supported `connector_id` values are:

data/lib/openai/models/realtime/realtime_tools_config_union.rb

@@ -48,8 +48,8 @@ module OpenAI
 
           # @!attribute connector_id
           #   Identifier for service connectors, like those available in ChatGPT. One of
-          #   `server_url` or `connector_id` must be provided. Learn more about service
-          #   connectors
+          #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          #   service connectors
           #   [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           #   Currently supported `connector_id` values are:
@@ -94,13 +94,20 @@ module OpenAI
           optional :server_description, String
 
           # @!attribute server_url
-          #   The URL for the MCP server. One of `server_url` or `connector_id` must be
-          #   provided.
+          #   The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+          #   must be provided.
           #
           #   @return [String, nil]
           optional :server_url, String
 
-          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
+          # @!attribute tunnel_id
+          #   The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+          #   `server_url`, `connector_id`, or `tunnel_id` must be provided.
+          #
+          #   @return [String, nil]
+          optional :tunnel_id, String
+
+          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, tunnel_id: nil, type: :mcp)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp} for more details.
           #
@@ -124,7 +131,9 @@ module OpenAI
           #
           #   @param server_description [String] Optional description of the MCP server, used to provide more context.
           #
-          #   @param server_url [String] The URL for the MCP server. One of `server_url` or `connector_id` must be
+          #   @param server_url [String] The URL for the MCP server. One of `server_url`, `connector_id`, or
+          #
+          #   @param tunnel_id [String] The Secure MCP Tunnel ID to use instead of a direct server URL. One of
           #
           #   @param type [Symbol, :mcp] The type of the MCP tool. Always `mcp`.
 
@@ -176,8 +185,8 @@ module OpenAI
           end
 
           # Identifier for service connectors, like those available in ChatGPT. One of
-          # `server_url` or `connector_id` must be provided. Learn more about service
-          # connectors
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          # service connectors
           # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           # Currently supported `connector_id` values are:

data/lib/openai/models/responses/tool.rb

@@ -87,8 +87,8 @@ module OpenAI
 
           # @!attribute connector_id
           #   Identifier for service connectors, like those available in ChatGPT. One of
-          #   `server_url` or `connector_id` must be provided. Learn more about service
-          #   connectors
+          #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          #   service connectors
           #   [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           #   Currently supported `connector_id` values are:
@@ -131,13 +131,20 @@ module OpenAI
           optional :server_description, String
 
           # @!attribute server_url
-          #   The URL for the MCP server. One of `server_url` or `connector_id` must be
-          #   provided.
+          #   The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+          #   must be provided.
           #
           #   @return [String, nil]
           optional :server_url, String
 
-          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
+          # @!attribute tunnel_id
+          #   The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+          #   `server_url`, `connector_id`, or `tunnel_id` must be provided.
+          #
+          #   @return [String, nil]
+          optional :tunnel_id, String
+
+          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, tunnel_id: nil, type: :mcp)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::Tool::Mcp} for more details.
           #
@@ -161,7 +168,9 @@ module OpenAI
           #
           #   @param server_description [String] Optional description of the MCP server, used to provide more context.
           #
-          #   @param server_url [String] The URL for the MCP server. One of `server_url` or `connector_id` must be
+          #   @param server_url [String] The URL for the MCP server. One of `server_url`, `connector_id`, or
+          #
+          #   @param tunnel_id [String] The Secure MCP Tunnel ID to use instead of a direct server URL. One of
           #
           #   @param type [Symbol, :mcp] The type of the MCP tool. Always `mcp`.
 
@@ -213,8 +222,8 @@ module OpenAI
           end
 
           # Identifier for service connectors, like those available in ChatGPT. One of
-          # `server_url` or `connector_id` must be provided. Learn more about service
-          # connectors
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          # service connectors
           # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           # Currently supported `connector_id` values are:

data/lib/openai/models/video_create_params.rb

@@ -62,6 +62,7 @@ module OpenAI
         # Optional reference asset upload or reference object that guides generation.
         variant OpenAI::Internal::Type::FileInput
 
+        # Optional reference asset upload or reference object that guides generation. Provide exactly one of `image_url` or `file_id` when using an object.
         variant -> { OpenAI::ImageInputReferenceParam }
 
         # @!method self.variants

data/lib/openai/models/video_edit_params.rb

@@ -33,7 +33,7 @@ module OpenAI
         # Reference to the completed video to edit.
         variant OpenAI::Internal::Type::FileInput
 
-        # Reference to the completed video.
+        # Reference to the completed video to edit.
         variant -> { OpenAI::VideoEditParams::Video::VideoReferenceInputParam }
 
         class VideoReferenceInputParam < OpenAI::Internal::Type::BaseModel
@@ -44,7 +44,7 @@ module OpenAI
           required :id, String
 
           # @!method initialize(id:)
-          #   Reference to the completed video.
+          #   Reference to the completed video to edit.
           #
           #   @param id [String] The identifier of the completed video.
         end

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.67.0"
+  VERSION = "0.68.0"
 end

data/rbi/openai/models/realtime/realtime_response_create_mcp_tool.rbi

@@ -43,8 +43,8 @@ module OpenAI
         attr_writer :authorization
 
         # Identifier for service connectors, like those available in ChatGPT. One of
-        # `server_url` or `connector_id` must be provided. Learn more about service
-        # connectors
+        # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+        # service connectors
         # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
         #
         # Currently supported `connector_id` values are:
@@ -106,14 +106,22 @@ module OpenAI
         sig { params(server_description: String).void }
         attr_writer :server_description
 
-        # The URL for the MCP server. One of `server_url` or `connector_id` must be
-        # provided.
+        # The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+        # must be provided.
         sig { returns(T.nilable(String)) }
         attr_reader :server_url
 
         sig { params(server_url: String).void }
         attr_writer :server_url
 
+        # The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+        # `server_url`, `connector_id`, or `tunnel_id` must be provided.
+        sig { returns(T.nilable(String)) }
+        attr_reader :tunnel_id
+
+        sig { params(tunnel_id: String).void }
+        attr_writer :tunnel_id
+
         # Give the model access to additional tools via remote Model Context Protocol
         # (MCP) servers.
         # [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
@@ -141,6 +149,7 @@ module OpenAI
               ),
             server_description: String,
             server_url: String,
+            tunnel_id: String,
             type: Symbol
           ).returns(T.attached_class)
         end
@@ -154,8 +163,8 @@ module OpenAI
           # OAuth authorization flow and provide the token here.
           authorization: nil,
           # Identifier for service connectors, like those available in ChatGPT. One of
-          # `server_url` or `connector_id` must be provided. Learn more about service
-          # connectors
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          # service connectors
           # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           # Currently supported `connector_id` values are:
@@ -178,9 +187,12 @@ module OpenAI
           require_approval: nil,
           # Optional description of the MCP server, used to provide more context.
           server_description: nil,
-          # The URL for the MCP server. One of `server_url` or `connector_id` must be
-          # provided.
+          # The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+          # must be provided.
           server_url: nil,
+          # The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided.
+          tunnel_id: nil,
           # The type of the MCP tool. Always `mcp`.
           type: :mcp
         )
@@ -211,7 +223,8 @@ module OpenAI
                   )
                 ),
               server_description: String,
-              server_url: String
+              server_url: String,
+              tunnel_id: String
             }
           )
         end
@@ -301,8 +314,8 @@ module OpenAI
         end
 
         # Identifier for service connectors, like those available in ChatGPT. One of
-        # `server_url` or `connector_id` must be provided. Learn more about service
-        # connectors
+        # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+        # service connectors
         # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
         #
         # Currently supported `connector_id` values are:

data/rbi/openai/models/realtime/realtime_session_create_response.rbi

@@ -1531,8 +1531,8 @@ module OpenAI
             attr_writer :authorization
 
             # Identifier for service connectors, like those available in ChatGPT. One of
-            # `server_url` or `connector_id` must be provided. Learn more about service
-            # connectors
+            # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+            # service connectors
             # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
             #
             # Currently supported `connector_id` values are:
@@ -1591,14 +1591,22 @@ module OpenAI
             sig { params(server_description: String).void }
             attr_writer :server_description
 
-            # The URL for the MCP server. One of `server_url` or `connector_id` must be
-            # provided.
+            # The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+            # must be provided.
             sig { returns(T.nilable(String)) }
             attr_reader :server_url
 
             sig { params(server_url: String).void }
             attr_writer :server_url
 
+            # The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+            # `server_url`, `connector_id`, or `tunnel_id` must be provided.
+            sig { returns(T.nilable(String)) }
+            attr_reader :tunnel_id
+
+            sig { params(tunnel_id: String).void }
+            attr_writer :tunnel_id
+
             # Give the model access to additional tools via remote Model Context Protocol
             # (MCP) servers.
             # [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
@@ -1626,6 +1634,7 @@ module OpenAI
                   ),
                 server_description: String,
                 server_url: String,
+                tunnel_id: String,
                 type: Symbol
               ).returns(T.attached_class)
             end
@@ -1639,8 +1648,8 @@ module OpenAI
               # OAuth authorization flow and provide the token here.
               authorization: nil,
               # Identifier for service connectors, like those available in ChatGPT. One of
-              # `server_url` or `connector_id` must be provided. Learn more about service
-              # connectors
+              # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+              # service connectors
               # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
               #
               # Currently supported `connector_id` values are:
@@ -1663,9 +1672,12 @@ module OpenAI
               require_approval: nil,
               # Optional description of the MCP server, used to provide more context.
               server_description: nil,
-              # The URL for the MCP server. One of `server_url` or `connector_id` must be
-              # provided.
+              # The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+              # must be provided.
               server_url: nil,
+              # The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+              # `server_url`, `connector_id`, or `tunnel_id` must be provided.
+              tunnel_id: nil,
               # The type of the MCP tool. Always `mcp`.
               type: :mcp
             )
@@ -1690,7 +1702,8 @@ module OpenAI
                       OpenAI::Realtime::RealtimeSessionCreateResponse::Tool::McpTool::RequireApproval::Variants
                     ),
                   server_description: String,
-                  server_url: String
+                  server_url: String,
+                  tunnel_id: String
                 }
               )
             end
@@ -1780,8 +1793,8 @@ module OpenAI
             end
 
             # Identifier for service connectors, like those available in ChatGPT. One of
-            # `server_url` or `connector_id` must be provided. Learn more about service
-            # connectors
+            # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+            # service connectors
             # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
             #
             # Currently supported `connector_id` values are:

data/rbi/openai/models/realtime/realtime_tools_config_union.rbi

@@ -57,8 +57,8 @@ module OpenAI
           attr_writer :authorization
 
           # Identifier for service connectors, like those available in ChatGPT. One of
-          # `server_url` or `connector_id` must be provided. Learn more about service
-          # connectors
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          # service connectors
           # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           # Currently supported `connector_id` values are:
@@ -120,14 +120,22 @@ module OpenAI
           sig { params(server_description: String).void }
           attr_writer :server_description
 
-          # The URL for the MCP server. One of `server_url` or `connector_id` must be
-          # provided.
+          # The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+          # must be provided.
           sig { returns(T.nilable(String)) }
           attr_reader :server_url
 
           sig { params(server_url: String).void }
           attr_writer :server_url
 
+          # The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided.
+          sig { returns(T.nilable(String)) }
+          attr_reader :tunnel_id
+
+          sig { params(tunnel_id: String).void }
+          attr_writer :tunnel_id
+
           # Give the model access to additional tools via remote Model Context Protocol
           # (MCP) servers.
           # [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
@@ -155,6 +163,7 @@ module OpenAI
                 ),
               server_description: String,
               server_url: String,
+              tunnel_id: String,
               type: Symbol
             ).returns(T.attached_class)
           end
@@ -168,8 +177,8 @@ module OpenAI
             # OAuth authorization flow and provide the token here.
             authorization: nil,
             # Identifier for service connectors, like those available in ChatGPT. One of
-            # `server_url` or `connector_id` must be provided. Learn more about service
-            # connectors
+            # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+            # service connectors
             # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
             #
             # Currently supported `connector_id` values are:
@@ -192,9 +201,12 @@ module OpenAI
             require_approval: nil,
             # Optional description of the MCP server, used to provide more context.
             server_description: nil,
-            # The URL for the MCP server. One of `server_url` or `connector_id` must be
-            # provided.
+            # The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+            # must be provided.
             server_url: nil,
+            # The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+            # `server_url`, `connector_id`, or `tunnel_id` must be provided.
+            tunnel_id: nil,
             # The type of the MCP tool. Always `mcp`.
             type: :mcp
           )
@@ -225,7 +237,8 @@ module OpenAI
                     )
                   ),
                 server_description: String,
-                server_url: String
+                server_url: String,
+                tunnel_id: String
               }
             )
           end
@@ -315,8 +328,8 @@ module OpenAI
           end
 
           # Identifier for service connectors, like those available in ChatGPT. One of
-          # `server_url` or `connector_id` must be provided. Learn more about service
-          # connectors
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          # service connectors
           # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           # Currently supported `connector_id` values are:

data/rbi/openai/models/responses/tool.rbi

@@ -65,8 +65,8 @@ module OpenAI
           attr_writer :authorization
 
           # Identifier for service connectors, like those available in ChatGPT. One of
-          # `server_url` or `connector_id` must be provided. Learn more about service
-          # connectors
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          # service connectors
           # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           # Currently supported `connector_id` values are:
@@ -125,14 +125,22 @@ module OpenAI
           sig { params(server_description: String).void }
           attr_writer :server_description
 
-          # The URL for the MCP server. One of `server_url` or `connector_id` must be
-          # provided.
+          # The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+          # must be provided.
           sig { returns(T.nilable(String)) }
           attr_reader :server_url
 
           sig { params(server_url: String).void }
           attr_writer :server_url
 
+          # The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided.
+          sig { returns(T.nilable(String)) }
+          attr_reader :tunnel_id
+
+          sig { params(tunnel_id: String).void }
+          attr_writer :tunnel_id
+
           # Give the model access to additional tools via remote Model Context Protocol
           # (MCP) servers.
           # [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
@@ -159,6 +167,7 @@ module OpenAI
                 ),
               server_description: String,
               server_url: String,
+              tunnel_id: String,
               type: Symbol
             ).returns(T.attached_class)
           end
@@ -172,8 +181,8 @@ module OpenAI
             # OAuth authorization flow and provide the token here.
             authorization: nil,
             # Identifier for service connectors, like those available in ChatGPT. One of
-            # `server_url` or `connector_id` must be provided. Learn more about service
-            # connectors
+            # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+            # service connectors
             # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
             #
             # Currently supported `connector_id` values are:
@@ -196,9 +205,12 @@ module OpenAI
             require_approval: nil,
             # Optional description of the MCP server, used to provide more context.
             server_description: nil,
-            # The URL for the MCP server. One of `server_url` or `connector_id` must be
-            # provided.
+            # The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+            # must be provided.
             server_url: nil,
+            # The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+            # `server_url`, `connector_id`, or `tunnel_id` must be provided.
+            tunnel_id: nil,
             # The type of the MCP tool. Always `mcp`.
             type: :mcp
           )
@@ -229,7 +241,8 @@ module OpenAI
                     )
                   ),
                 server_description: String,
-                server_url: String
+                server_url: String,
+                tunnel_id: String
               }
             )
           end
@@ -317,8 +330,8 @@ module OpenAI
           end
 
           # Identifier for service connectors, like those available in ChatGPT. One of
-          # `server_url` or `connector_id` must be provided. Learn more about service
-          # connectors
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          # service connectors
           # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           # Currently supported `connector_id` values are:

data/rbi/openai/models/video_edit_params.rbi

@@ -87,7 +87,7 @@ module OpenAI
           sig { returns(String) }
           attr_accessor :id
 
-          # Reference to the completed video.
+          # Reference to the completed video to edit.
           sig { params(id: String).returns(T.attached_class) }
           def self.new(
             # The identifier of the completed video.

data/sig/openai/models/realtime/realtime_response_create_mcp_tool.rbs

@@ -12,7 +12,8 @@ module OpenAI
           headers: ::Hash[Symbol, String]?,
           require_approval: OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::require_approval?,
           server_description: String,
-          server_url: String
+          server_url: String,
+          tunnel_id: String
         }
 
       class RealtimeResponseCreateMcpTool < OpenAI::Internal::Type::BaseModel
@@ -48,6 +49,10 @@ module OpenAI
 
         def server_url=: (String) -> String
 
+        attr_reader tunnel_id: String?
+
+        def tunnel_id=: (String) -> String
+
         def initialize: (
           server_label: String,
           ?allowed_tools: OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::allowed_tools?,
@@ -58,6 +63,7 @@ module OpenAI
           ?require_approval: OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::require_approval?,
           ?server_description: String,
           ?server_url: String,
+          ?tunnel_id: String,
           ?type: :mcp
         ) -> void
 
@@ -71,7 +77,8 @@ module OpenAI
           headers: ::Hash[Symbol, String]?,
           require_approval: OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::require_approval?,
           server_description: String,
-          server_url: String
+          server_url: String,
+          tunnel_id: String
         }
 
         type allowed_tools =

data/sig/openai/models/realtime/realtime_session_create_response.rbs

@@ -516,7 +516,8 @@ module OpenAI
               headers: ::Hash[Symbol, String]?,
               require_approval: OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Tool::McpTool::require_approval?,
               server_description: String,
-              server_url: String
+              server_url: String,
+              tunnel_id: String
             }
 
           class McpTool < OpenAI::Internal::Type::BaseModel
@@ -552,6 +553,10 @@ module OpenAI
 
             def server_url=: (String) -> String
 
+            attr_reader tunnel_id: String?
+
+            def tunnel_id=: (String) -> String
+
             def initialize: (
               server_label: String,
               ?allowed_tools: OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Tool::McpTool::allowed_tools?,
@@ -562,6 +567,7 @@ module OpenAI
               ?require_approval: OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Tool::McpTool::require_approval?,
               ?server_description: String,
               ?server_url: String,
+              ?tunnel_id: String,
               ?type: :mcp
             ) -> void
 
@@ -575,7 +581,8 @@ module OpenAI
               headers: ::Hash[Symbol, String]?,
               require_approval: OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Tool::McpTool::require_approval?,
               server_description: String,
-              server_url: String
+              server_url: String,
+              tunnel_id: String
             }
 
             type allowed_tools =

data/sig/openai/models/realtime/realtime_tools_config_union.rbs

@@ -19,7 +19,8 @@ module OpenAI
             headers: ::Hash[Symbol, String]?,
             require_approval: OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp::require_approval?,
             server_description: String,
-            server_url: String
+            server_url: String,
+            tunnel_id: String
           }
 
         class Mcp < OpenAI::Internal::Type::BaseModel
@@ -55,6 +56,10 @@ module OpenAI
 
           def server_url=: (String) -> String
 
+          attr_reader tunnel_id: String?
+
+          def tunnel_id=: (String) -> String
+
           def initialize: (
             server_label: String,
             ?allowed_tools: OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp::allowed_tools?,
@@ -65,6 +70,7 @@ module OpenAI
             ?require_approval: OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp::require_approval?,
             ?server_description: String,
             ?server_url: String,
+            ?tunnel_id: String,
             ?type: :mcp
           ) -> void
 
@@ -78,7 +84,8 @@ module OpenAI
             headers: ::Hash[Symbol, String]?,
             require_approval: OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp::require_approval?,
             server_description: String,
-            server_url: String
+            server_url: String,
+            tunnel_id: String
           }
 
           type allowed_tools =

data/sig/openai/models/responses/tool.rbs

@@ -32,7 +32,8 @@ module OpenAI
             headers: ::Hash[Symbol, String]?,
             require_approval: OpenAI::Models::Responses::Tool::Mcp::require_approval?,
             server_description: String,
-            server_url: String
+            server_url: String,
+            tunnel_id: String
           }
 
         class Mcp < OpenAI::Internal::Type::BaseModel
@@ -68,6 +69,10 @@ module OpenAI
 
           def server_url=: (String) -> String
 
+          attr_reader tunnel_id: String?
+
+          def tunnel_id=: (String) -> String
+
           def initialize: (
             server_label: String,
             ?allowed_tools: OpenAI::Models::Responses::Tool::Mcp::allowed_tools?,
@@ -78,6 +83,7 @@ module OpenAI
             ?require_approval: OpenAI::Models::Responses::Tool::Mcp::require_approval?,
             ?server_description: String,
             ?server_url: String,
+            ?tunnel_id: String,
             ?type: :mcp
           ) -> void
 
@@ -91,7 +97,8 @@ module OpenAI
             headers: ::Hash[Symbol, String]?,
             require_approval: OpenAI::Models::Responses::Tool::Mcp::require_approval?,
             server_description: String,
-            server_url: String
+            server_url: String,
+            tunnel_id: String
           }
 
           type allowed_tools =

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openai
 version: !ruby/object:Gem::Version
-  version: 0.67.0
+  version: 0.68.0
 platform: ruby
 authors:
 - OpenAI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-16 00:00:00.000000000 Z
+date: 2026-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64