openai 0.91.0 → 0.93.0

data/lib/openai/models/beta/environment_param.rb

@@ -70,13 +70,14 @@ module OpenAI
           )
 
           # @!attribute network
-          #   Network access for an OpenAI-hosted environment.
+          #   Network access policy for the environment. Defaults to disabled for GA requests
+          #   and enabled for alpha/beta requests.
           #
           #   @return [OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Network, nil]
           optional :network, -> { OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network }, nil?: true
 
           # @!attribute packages
-          #   Packages to install in an OpenAI-hosted environment.
+          #   Packages to install in the environment. Defaults to empty package lists.
           #
           #   @return [OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Packages, nil]
           optional :packages, -> { OpenAI::Beta::EnvironmentParam::OpenAIHosted::Packages }, nil?: true
@@ -132,10 +133,11 @@ module OpenAI
           #     Files available before the agent starts. Defaults to an empty list.
           #
           #   @param network [OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Network, nil]
-          #     Network access for an OpenAI-hosted environment.
+          #     Network access policy for the environment. Defaults to disabled for GA requests
+          #     and enabled for alpha/beta requests.
           #
           #   @param packages [OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Packages, nil]
-          #     Packages to install in an OpenAI-hosted environment.
+          #     Packages to install in the environment. Defaults to empty package lists.
           #
           #   @param plugins [Array<OpenAI::Models::Beta::HostedPluginParam>, nil]
           #     Plugins provided as inline ZIP archives. Defaults to an empty list.
@@ -165,7 +167,8 @@ module OpenAI
             optional :allowed_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
             # @!method initialize(access:, allowed_domains: nil)
-            #   Network access for an OpenAI-hosted environment.
+            #   Network access policy for the environment. Defaults to disabled for GA requests
+            #   and enabled for alpha/beta requests.
             #
             #   @param access [Symbol, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Network::Access]
             #     The environment's network access mode.
@@ -179,7 +182,7 @@ module OpenAI
             module Access
               extend OpenAI::Internal::Type::Enum
 
-              # Allows unrestricted network access, matching an omitted network policy.
+              # Allows unrestricted network access.
               ENABLED = :enabled
 
               # Disables network access.
@@ -214,7 +217,7 @@ module OpenAI
             optional :system_, OpenAI::Internal::Type::ArrayOf[String], api_name: :system, nil?: true
 
             # @!method initialize(npm: nil, python: nil, system_: nil)
-            #   Packages to install in an OpenAI-hosted environment.
+            #   Packages to install in the environment. Defaults to empty package lists.
             #
             #   @param npm [Array<String>, nil]
             #     npm packages to install globally. Defaults to an empty list.

data/lib/openai/models/beta/persisted_agent_tool.rb

@@ -215,7 +215,7 @@ module OpenAI
           required :context_size, enum: -> { OpenAI::Beta::PersistedAgentTool::WebSearch::ContextSize }
 
           # @!attribute location
-          #   Approximate user location used to localize web search results.
+          #   Approximate location used to localize search results, if provided.
           #
           #   @return [OpenAI::Models::Beta::PersistedAgentTool::WebSearch::Location, nil]
           required :location, -> { OpenAI::Beta::PersistedAgentTool::WebSearch::Location }, nil?: true
@@ -242,7 +242,7 @@ module OpenAI
           #     The amount of search context made available to the model. Defaults to `medium`.
           #
           #   @param location [OpenAI::Models::Beta::PersistedAgentTool::WebSearch::Location, nil]
-          #     Approximate user location used to localize web search results.
+          #     Approximate location used to localize search results, if provided.
           #
           #   @param mode [Symbol, OpenAI::Models::Beta::PersistedAgentTool::WebSearch::Mode]
           #     The source used for web search results.
@@ -291,7 +291,7 @@ module OpenAI
             required :timezone, String, nil?: true
 
             # @!method initialize(city:, country:, region:, timezone:)
-            #   Approximate user location used to localize web search results.
+            #   Approximate location used to localize search results, if provided.
             #
             #   @param city [String, nil]
             #     The city name.

data/lib/openai/models/beta/persisted_agent_tool_param.rb

@@ -139,7 +139,7 @@ module OpenAI
           optional :allowed_tools, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
           # @!attribute connection_origin
-          #   Where outbound MCP HTTP connections originate.
+          #   Selects where outbound MCP HTTP connections originate.
           #
           #   @return [Symbol, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp::ConnectionOrigin, nil]
           optional(
@@ -185,7 +185,7 @@ module OpenAI
           #     The MCP tools the agent may call. All server tools are allowed when omitted.
           #
           #   @param connection_origin [Symbol, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp::ConnectionOrigin, nil]
-          #     Where outbound MCP HTTP connections originate.
+          #     Selects where outbound MCP HTTP connections originate.
           #
           #   @param credential_id [String, nil]
           #     The vault credential selected for this MCP server. Optional when exactly one
@@ -201,7 +201,7 @@ module OpenAI
           #   @param type [Symbol, :mcp]
           #     The type of the object. Always `mcp`.
 
-          # Where outbound MCP HTTP connections originate.
+          # Selects where outbound MCP HTTP connections originate.
           #
           # @see OpenAI::Models::Beta::PersistedAgentToolParam::Mcp#connection_origin
           module ConnectionOrigin
@@ -232,7 +232,7 @@ module OpenAI
           optional :allowed_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
           # @!attribute context_size
-          #   The amount of web search context made available to the model.
+          #   The amount of search context made available to the model. Defaults to `medium`.
           #
           #   @return [Symbol, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch::ContextSize, nil]
           optional(
@@ -242,13 +242,13 @@ module OpenAI
           )
 
           # @!attribute location
-          #   Approximate user location used to localize web search results.
+          #   Approximate location used to localize search results.
           #
           #   @return [OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch::Location, nil]
           optional :location, -> { OpenAI::Beta::PersistedAgentToolParam::WebSearch::Location }, nil?: true
 
           # @!attribute mode
-          #   The source used for web search results.
+          #   The source used for web search results. Defaults to `live`.
           #
           #   @return [Symbol, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch::Mode, nil]
           optional :mode, enum: -> { OpenAI::Beta::PersistedAgentToolParam::WebSearch::Mode }, nil?: true
@@ -260,18 +260,18 @@ module OpenAI
           #     Domains the search may include.
           #
           #   @param context_size [Symbol, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch::ContextSize, nil]
-          #     The amount of web search context made available to the model.
+          #     The amount of search context made available to the model. Defaults to `medium`.
           #
           #   @param location [OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch::Location, nil]
-          #     Approximate user location used to localize web search results.
+          #     Approximate location used to localize search results.
           #
           #   @param mode [Symbol, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch::Mode, nil]
-          #     The source used for web search results.
+          #     The source used for web search results. Defaults to `live`.
           #
           #   @param type [Symbol, :web_search]
           #     The type of the object. Always `web_search`.
 
-          # The amount of web search context made available to the model.
+          # The amount of search context made available to the model. Defaults to `medium`.
           #
           # @see OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch#context_size
           module ContextSize
@@ -312,7 +312,7 @@ module OpenAI
             optional :timezone, String, nil?: true
 
             # @!method initialize(city: nil, country: nil, region: nil, timezone: nil)
-            #   Approximate user location used to localize web search results.
+            #   Approximate location used to localize search results.
             #
             #   @param city [String, nil]
             #     The city name.
@@ -327,7 +327,7 @@ module OpenAI
             #     The IANA timezone, such as `America/Los_Angeles`.
           end
 
-          # The source used for web search results.
+          # The source used for web search results. Defaults to `live`.
           #
           # @see OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch#mode
           module Mode

data/lib/openai/models/beta/response_compact_params.rb

@@ -216,6 +216,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_5_1_CODEX }
 
+          variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_5_1_MINI }
+
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_5_1_CHAT_LATEST }
 
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_5 }
@@ -350,8 +352,6 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_3_5_TURBO_16K_0613 }
 
-          variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_5_1_MINI }
-
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::O1_PRO }
 
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::O1_PRO_2025_03_19 }
@@ -421,6 +421,7 @@ module OpenAI
           GPT_5_1 = :"gpt-5.1"
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           GPT_5_1_CODEX = :"gpt-5.1-codex"
+          GPT_5_1_MINI = :"gpt-5.1-mini"
           GPT_5_1_CHAT_LATEST = :"gpt-5.1-chat-latest"
           GPT_5 = :"gpt-5"
           GPT_5_MINI = :"gpt-5-mini"
@@ -486,7 +487,6 @@ module OpenAI
           GPT_3_5_TURBO_1106 = :"gpt-3.5-turbo-1106"
           GPT_3_5_TURBO_0125 = :"gpt-3.5-turbo-0125"
           GPT_3_5_TURBO_16K_0613 = :"gpt-3.5-turbo-16k-0613"
-          GPT_5_1_MINI = :"gpt-5.1-mini"
           O1_PRO = :"o1-pro"
           O1_PRO_2025_03_19 = :"o1-pro-2025-03-19"
           O3_PRO = :"o3-pro"

data/lib/openai/models/beta/response_create_params.rb

@@ -739,6 +739,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_5_1_CODEX }
 
+          variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_5_1_MINI }
+
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_5_1_CHAT_LATEST }
 
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_5 }
@@ -871,8 +873,6 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_3_5_TURBO_16K_0613 }
 
-          variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_5_1_MINI }
-
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::O1_PRO }
 
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::O1_PRO_2025_03_19 }
@@ -942,6 +942,7 @@ module OpenAI
           GPT_5_1 = :"gpt-5.1"
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           GPT_5_1_CODEX = :"gpt-5.1-codex"
+          GPT_5_1_MINI = :"gpt-5.1-mini"
           GPT_5_1_CHAT_LATEST = :"gpt-5.1-chat-latest"
           GPT_5 = :"gpt-5"
           GPT_5_MINI = :"gpt-5-mini"
@@ -1007,7 +1008,6 @@ module OpenAI
           GPT_3_5_TURBO_1106 = :"gpt-3.5-turbo-1106"
           GPT_3_5_TURBO_0125 = :"gpt-3.5-turbo-0125"
           GPT_3_5_TURBO_16K_0613 = :"gpt-3.5-turbo-16k-0613"
-          GPT_5_1_MINI = :"gpt-5.1-mini"
           O1_PRO = :"o1-pro"
           O1_PRO_2025_03_19 = :"o1-pro-2025-03-19"
           O3_PRO = :"o3-pro"

data/lib/openai/models/chat/completion_create_params.rb

@@ -180,8 +180,11 @@ module OpenAI
         optional :parallel_tool_calls, OpenAI::Internal::Type::Boolean
 
         # @!attribute prediction
-        #   Static predicted output content, such as the content of a text file that is
-        #   being regenerated.
+        #   Configuration for a
+        #   [Predicted Output](https://developers.openai.com/api/docs/guides/predicted-outputs),
+        #   which can greatly improve response times when large parts of the model response
+        #   are known ahead of time. This is most common when you are regenerating a file
+        #   with only minor changes to most of the content.
         #
         #   @return [OpenAI::Models::Chat::ChatCompletionPredictionContent, nil]
         optional :prediction, -> { OpenAI::Chat::ChatCompletionPredictionContent }, nil?: true
@@ -546,8 +549,11 @@ module OpenAI
         #     during tool use.
         #
         #   @param prediction [OpenAI::Models::Chat::ChatCompletionPredictionContent, nil]
-        #     Static predicted output content, such as the content of a text file that is
-        #     being regenerated.
+        #     Configuration for a
+        #     [Predicted Output](https://developers.openai.com/api/docs/guides/predicted-outputs),
+        #     which can greatly improve response times when large parts of the model response
+        #     are known ahead of time. This is most common when you are regenerating a file
+        #     with only minor changes to most of the content.
         #
         #   @param presence_penalty [Float, nil]
         #     Number between -2.0 and 2.0. Positive values penalize new tokens based on

data/lib/openai/models/chat_model.rb

@@ -25,6 +25,7 @@ module OpenAI
       GPT_5_1 = :"gpt-5.1"
       GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
       GPT_5_1_CODEX = :"gpt-5.1-codex"
+      GPT_5_1_MINI = :"gpt-5.1-mini"
       GPT_5_1_CHAT_LATEST = :"gpt-5.1-chat-latest"
       GPT_5 = :"gpt-5"
       GPT_5_MINI = :"gpt-5-mini"
@@ -90,7 +91,6 @@ module OpenAI
       GPT_3_5_TURBO_1106 = :"gpt-3.5-turbo-1106"
       GPT_3_5_TURBO_0125 = :"gpt-3.5-turbo-0125"
       GPT_3_5_TURBO_16K_0613 = :"gpt-3.5-turbo-16k-0613"
-      GPT_5_1_MINI = :"gpt-5.1-mini"
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/openai/models/conversations/conversation_update_params.rb

@@ -16,10 +16,9 @@ module OpenAI
         # @!attribute metadata
         #   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.
+        #   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.
         #
         #   @return [Hash{Symbol=>String}, nil]
         required :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
@@ -30,10 +29,9 @@ module OpenAI
         #   @param metadata [Hash{Symbol=>String}, nil]
         #     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.
+        #     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.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openai/models/image_edit_params.rb

@@ -51,10 +51,9 @@ module OpenAI
       optional :background, enum: -> { OpenAI::ImageEditParams::Background }, nil?: true
 
       # @!attribute input_fidelity
-      #   Control how much effort the model will exert to match the style and features,
-      #   especially facial features, of input images. This parameter is only supported
-      #   for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-      #   `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+      #   Controls fidelity to the original input image(s). This parameter is supported
+      #   for GPT image models that support input fidelity. `gpt-image-2` and
+      #   `gpt-image-2-2026-04-21` ignore this parameter.
       #
       #   @return [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
       optional :input_fidelity, enum: -> { OpenAI::ImageEditParams::InputFidelity }, nil?: true
@@ -193,10 +192,9 @@ module OpenAI
       #     set the output format to `png` or `webp`.
       #
       #   @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
-      #     Control how much effort the model will exert to match the style and features,
-      #     especially facial features, of input images. This parameter is only supported
-      #     for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-      #     `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+      #     Controls fidelity to the original input image(s). This parameter is supported
+      #     for GPT image models that support input fidelity. `gpt-image-2` and
+      #     `gpt-image-2-2026-04-21` ignore this parameter.
       #
       #   @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #     An additional image whose fully transparent areas (e.g. where alpha is zero)
@@ -315,10 +313,9 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # Control how much effort the model will exert to match the style and features,
-      # especially facial features, of input images. This parameter is only supported
-      # for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-      # `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+      # Controls fidelity to the original input image(s). This parameter is supported
+      # for GPT image models that support input fidelity. `gpt-image-2` and
+      # `gpt-image-2-2026-04-21` ignore this parameter.
       module InputFidelity
         extend OpenAI::Internal::Type::Enum
 

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

@@ -42,8 +42,9 @@ module OpenAI
         #   "history" of the conversation and to add new items mid-stream, but has the
         #   current limitation that it cannot populate assistant audio messages.
         #
-        #   If successful, the server will respond with a `conversation.item.created` event,
-        #   otherwise an `error` event will be sent.
+        #   If successful, the server will emit a `conversation.item.added` event and, when
+        #   the item is finalized, a `conversation.item.done` event. Otherwise, an `error`
+        #   event will be sent.
         #
         #   @param item [OpenAI::Models::Realtime::RealtimeConversationItemSystemMessage, OpenAI::Models::Realtime::RealtimeConversationItemUserMessage, OpenAI::Models::Realtime::RealtimeConversationItemAssistantMessage, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCall, OpenAI::Models::Realtime::RealtimeConversationItemFunctionCallOutput, OpenAI::Models::Realtime::RealtimeMcpApprovalResponse, OpenAI::Models::Realtime::RealtimeMcpListTools, OpenAI::Models::Realtime::RealtimeMcpToolCall, OpenAI::Models::Realtime::RealtimeMcpApprovalRequest]
         #     A single item within a Realtime conversation.

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

@@ -14,8 +14,9 @@ module OpenAI
         # "history" of the conversation and to add new items mid-stream, but has the
         # current limitation that it cannot populate assistant audio messages.
         #
-        # If successful, the server will respond with a `conversation.item.created`
-        # event, otherwise an `error` event will be sent.
+        # If successful, the server will emit a `conversation.item.added` event and,
+        # when the item is finalized, a `conversation.item.done` event. Otherwise, an
+        # `error` event will be sent.
         variant :"conversation.item.create", -> { OpenAI::Realtime::ConversationItemCreateEvent }
 
         # Send this event when you want to remove any item from the conversation

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

@@ -47,11 +47,17 @@ module OpenAI
         optional :authorization, String
 
         # @!attribute connector_id
+        #   @deprecated
+        #
         #   Identifier for service connectors, like those available in ChatGPT. One of
         #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
         #   service connectors
         #   [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
         #
+        #   This field is deprecated for models released after September 1, 2026. Use
+        #   `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+        #   through a Secure MCP Tunnel.
+        #
         #   Currently supported `connector_id` values are:
         #
         #   - Dropbox: `connector_dropbox`
@@ -134,6 +140,10 @@ module OpenAI
         #     service connectors
         #     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
         #
+        #     This field is deprecated for models released after September 1, 2026. Use
+        #     `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+        #     through a Secure MCP Tunnel.
+        #
         #     Currently supported `connector_id` values are:
         #
         #     - Dropbox: `connector_dropbox`
@@ -226,11 +236,17 @@ module OpenAI
           StringArray = OpenAI::Internal::Type::ArrayOf[String]
         end
 
+        # @deprecated
+        #
         # Identifier for service connectors, like those available in ChatGPT. One of
         # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
         # service connectors
         # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
         #
+        # This field is deprecated for models released after September 1, 2026. Use
+        # `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+        # through a Secure MCP Tunnel.
+        #
         # Currently supported `connector_id` values are:
         #
         # - Dropbox: `connector_dropbox`

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

@@ -960,11 +960,17 @@ module OpenAI
             optional :authorization, String
 
             # @!attribute connector_id
+            #   @deprecated
+            #
             #   Identifier for service connectors, like those available in ChatGPT. One of
             #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
             #   service connectors
             #   [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
             #
+            #   This field is deprecated for models released after September 1, 2026. Use
+            #   `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+            #   through a Secure MCP Tunnel.
+            #
             #   Currently supported `connector_id` values are:
             #
             #   - Dropbox: `connector_dropbox`
@@ -1052,6 +1058,10 @@ module OpenAI
             #     service connectors
             #     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
             #
+            #     This field is deprecated for models released after September 1, 2026. Use
+            #     `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+            #     through a Secure MCP Tunnel.
+            #
             #     Currently supported `connector_id` values are:
             #
             #     - Dropbox: `connector_dropbox`
@@ -1150,11 +1160,17 @@ module OpenAI
               StringArray = OpenAI::Internal::Type::ArrayOf[String]
             end
 
+            # @deprecated
+            #
             # Identifier for service connectors, like those available in ChatGPT. One of
             # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
             # service connectors
             # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
             #
+            # This field is deprecated for models released after September 1, 2026. Use
+            # `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+            # through a Secure MCP Tunnel.
+            #
             # Currently supported `connector_id` values are:
             #
             # - Dropbox: `connector_dropbox`

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

@@ -61,11 +61,17 @@ module OpenAI
           optional :authorization, String
 
           # @!attribute connector_id
+          #   @deprecated
+          #
           #   Identifier for service connectors, like those available in ChatGPT. One of
           #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
           #   service connectors
           #   [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
           #
+          #   This field is deprecated for models released after September 1, 2026. Use
+          #   `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+          #   through a Secure MCP Tunnel.
+          #
           #   Currently supported `connector_id` values are:
           #
           #   - Dropbox: `connector_dropbox`
@@ -148,6 +154,10 @@ module OpenAI
           #     service connectors
           #     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
           #
+          #     This field is deprecated for models released after September 1, 2026. Use
+          #     `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+          #     through a Secure MCP Tunnel.
+          #
           #     Currently supported `connector_id` values are:
           #
           #     - Dropbox: `connector_dropbox`
@@ -240,11 +250,17 @@ module OpenAI
             StringArray = OpenAI::Internal::Type::ArrayOf[String]
           end
 
+          # @deprecated
+          #
           # Identifier for service connectors, like those available in ChatGPT. One of
           # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
           # service connectors
           # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
           #
+          # This field is deprecated for models released after September 1, 2026. Use
+          # `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+          # through a Secure MCP Tunnel.
+          #
           # Currently supported `connector_id` values are:
           #
           # - Dropbox: `connector_dropbox`

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

@@ -207,6 +207,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_1_CODEX }
 
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_1_MINI }
+
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_1_CHAT_LATEST }
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5 }
@@ -351,8 +353,6 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_3_5_TURBO_16K_0613 }
 
-          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_1_MINI }
-
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::O1_PRO }
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::O1_PRO_2025_03_19 }
@@ -426,6 +426,7 @@ module OpenAI
           GPT_5_1 = :"gpt-5.1"
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           GPT_5_1_CODEX = :"gpt-5.1-codex"
+          GPT_5_1_MINI = :"gpt-5.1-mini"
           GPT_5_1_CHAT_LATEST = :"gpt-5.1-chat-latest"
           GPT_5 = :"gpt-5"
           GPT_5_MINI = :"gpt-5-mini"
@@ -491,7 +492,6 @@ module OpenAI
           GPT_3_5_TURBO_1106 = :"gpt-3.5-turbo-1106"
           GPT_3_5_TURBO_0125 = :"gpt-3.5-turbo-0125"
           GPT_3_5_TURBO_16K_0613 = :"gpt-3.5-turbo-16k-0613"
-          GPT_5_1_MINI = :"gpt-5.1-mini"
           O1_PRO = :"o1-pro"
           O1_PRO_2025_03_19 = :"o1-pro-2025-03-19"
           O3_PRO = :"o3-pro"

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

@@ -5,7 +5,7 @@ module OpenAI
     module Responses
       class ResponseOutputTextAnnotationAddedEvent < OpenAI::Internal::Type::BaseModel
         # @!attribute annotation
-        #   An annotation that applies to a span of output text.
+        #   The annotation object being added. (See annotation schema for details.)
         #
         #   @return [OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FilePath, nil]
         required(
@@ -54,7 +54,7 @@ module OpenAI
         #   Emitted when an annotation is added to output text content.
         #
         #   @param annotation [OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FilePath, nil]
-        #     An annotation that applies to a span of output text.
+        #     The annotation object being added. (See annotation schema for details.)
         #
         #   @param annotation_index [Integer]
         #     The index of the annotation within the content part.
@@ -74,7 +74,7 @@ module OpenAI
         #   @param type [Symbol, :"response.output_text.annotation.added"]
         #     The type of the event. Always 'response.output_text.annotation.added'.
 
-        # An annotation that applies to a span of output text.
+        # The annotation object being added. (See annotation schema for details.)
         #
         # @see OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent#annotation
         module Annotation

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

@@ -2018,7 +2018,7 @@ module OpenAI
           #   Emitted when an annotation is added to output text content.
           #
           #   @param annotation [OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::URLCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::ContainerFileCitation, OpenAI::Models::Responses::ResponseOutputTextAnnotationAddedEvent::Annotation::FilePath, nil]
-          #     An annotation that applies to a span of output text.
+          #     The annotation object being added. (See annotation schema for details.)
           #
           #   @param annotation_index [Integer]
           #     The index of the annotation within the content part.