openai 0.113.0 → 0.115.0

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

@@ -45,9 +45,9 @@ module OpenAI
         optional :filename, String, nil?: true
 
         # @!attribute prompt_cache_breakpoint
-        #   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.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         #
         #   @return [OpenAI::Models::Responses::ResponseInputFileContent::PromptCacheBreakpoint, nil]
         optional(
@@ -79,9 +79,9 @@ module OpenAI
         #     The name of the file to be sent to the model.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Responses::ResponseInputFileContent::PromptCacheBreakpoint, nil]
-        #     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.
+        #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #     not rounded to a token block.
         #
         #   @param type [Symbol, :input_file]
         #     The type of the input item. Always `input_file`.
@@ -119,9 +119,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Responses::ResponseInputFileContent::PromptCacheBreakpoint::Ttl }
 
           # @!method initialize(ttl: nil, mode: :explicit)
-          #   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.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputFileContent::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -31,9 +31,9 @@ module OpenAI
         optional :image_url, String, nil?: true
 
         # @!attribute prompt_cache_breakpoint
-        #   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.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         #
         #   @return [OpenAI::Models::Responses::ResponseInputImage::PromptCacheBreakpoint, nil]
         optional :prompt_cache_breakpoint, -> { OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint }
@@ -54,9 +54,9 @@ module OpenAI
         #     encoded image in a data URL.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Responses::ResponseInputImage::PromptCacheBreakpoint]
-        #     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.
+        #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #     not rounded to a token block.
         #
         #   @param type [Symbol, :input_image]
         #     The type of the input item. Always `input_image`.
@@ -92,9 +92,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint::Ttl }
 
           # @!method initialize(ttl: nil, mode: :explicit)
-          #   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.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputImage::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -31,9 +31,9 @@ module OpenAI
         optional :image_url, String, nil?: true
 
         # @!attribute prompt_cache_breakpoint
-        #   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.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         #
         #   @return [OpenAI::Models::Responses::ResponseInputImageContent::PromptCacheBreakpoint, nil]
         optional(
@@ -58,9 +58,9 @@ module OpenAI
         #     encoded image in a data URL.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Responses::ResponseInputImageContent::PromptCacheBreakpoint, nil]
-        #     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.
+        #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #     not rounded to a token block.
         #
         #   @param type [Symbol, :input_image]
         #     The type of the input item. Always `input_image`.
@@ -96,9 +96,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Responses::ResponseInputImageContent::PromptCacheBreakpoint::Ttl }
 
           # @!method initialize(ttl: nil, mode: :explicit)
-          #   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.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputImageContent::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -56,9 +56,8 @@ module OpenAI
 
         variant :additional_tools, -> { OpenAI::Responses::ResponseInputItem::AdditionalTools }
 
-        # An update to the conversation's response configuration. The configuration
-        # remains in effect for subsequent responses until it is replaced by another
-        # configuration update.
+        # An update to the conversation's response configuration. Supply reasoning,
+        # text, or both. Each setting stays in effect until a later update replaces it.
         variant :configuration_update, -> { OpenAI::Responses::ResponseConfigurationUpdateItemParam }
 
         # A description of the chain of thought used by a reasoning model while generating

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

@@ -17,9 +17,9 @@ module OpenAI
         required :type, const: :input_text
 
         # @!attribute prompt_cache_breakpoint
-        #   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.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         #
         #   @return [OpenAI::Models::Responses::ResponseInputText::PromptCacheBreakpoint, nil]
         optional :prompt_cache_breakpoint, -> { OpenAI::Responses::ResponseInputText::PromptCacheBreakpoint }
@@ -31,9 +31,9 @@ module OpenAI
         #     The text input to the model.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Responses::ResponseInputText::PromptCacheBreakpoint]
-        #     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.
+        #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #     not rounded to a token block.
         #
         #   @param type [Symbol, :input_text]
         #     The type of the input item. Always `input_text`.
@@ -53,9 +53,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Responses::ResponseInputText::PromptCacheBreakpoint::Ttl }
 
           # @!method initialize(ttl: nil, mode: :explicit)
-          #   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.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputText::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -17,9 +17,9 @@ module OpenAI
         required :type, const: :input_text
 
         # @!attribute prompt_cache_breakpoint
-        #   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.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         #
         #   @return [OpenAI::Models::Responses::ResponseInputTextContent::PromptCacheBreakpoint, nil]
         optional(
@@ -35,9 +35,9 @@ module OpenAI
         #     The text input to the model.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Responses::ResponseInputTextContent::PromptCacheBreakpoint, nil]
-        #     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.
+        #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #     not rounded to a token block.
         #
         #   @param type [Symbol, :input_text]
         #     The type of the input item. Always `input_text`.
@@ -57,9 +57,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Responses::ResponseInputTextContent::PromptCacheBreakpoint::Ttl }
 
           # @!method initialize(ttl: nil, mode: :explicit)
-          #   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.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseInputTextContent::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -40,8 +40,8 @@ module OpenAI
 
         variant :additional_tools, -> { OpenAI::Responses::ResponseItem::AdditionalTools }
 
-        # A configuration update that applies to subsequent responses until it is
-        # replaced by another configuration update.
+        # A configuration update for subsequent responses. Each setting stays in effect
+        # until a later update replaces that setting.
         variant :configuration_update, -> { OpenAI::Responses::ResponseConfigurationUpdateItem }
 
         # A description of the chain of thought used by a reasoning model while generating

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

@@ -755,8 +755,8 @@ module OpenAI
             # @!attribute input_fidelity
             #   Control how much effort the model will exert to match the style and features,
             #   especially facial features, of input images. Supports `high` and `low` on
-            #   `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            #   `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            #   this parameter. Defaults to `low` on supported models.
             #
             #   @return [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity, nil]
             optional(
@@ -875,8 +875,8 @@ module OpenAI
             #   @param input_fidelity [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity, nil]
             #     Control how much effort the model will exert to match the style and features,
             #     especially facial features, of input images. Supports `high` and `low` on
-            #     `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            #     `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            #     `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            #     this parameter. Defaults to `low` on supported models.
             #
             #   @param input_image_mask [OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputImageMask]
             #     Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -965,8 +965,8 @@ module OpenAI
 
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. Supports `high` and `low` on
-            # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            # this parameter. Defaults to `low` on supported models.
             #
             # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#input_fidelity
             module InputFidelity

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

@@ -96,6 +96,14 @@ module OpenAI
             nil?: true
           )
 
+          # @!attribute generate
+          #   Whether to generate output for this response. Defaults to true when omitted. Set
+          #   to false to prepare request state without model output; the response ID can be
+          #   used as previous_response_id on a later turn.
+          #
+          #   @return [Boolean, nil]
+          optional :generate, OpenAI::Internal::Type::Boolean
+
           # @!attribute include
           #   Specify additional output data to include in the model response. Currently
           #   supported values are:
@@ -463,7 +471,7 @@ module OpenAI
           #   @return [String, nil]
           optional :user, String
 
-          # @!method initialize(access_programs: nil, background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
+          # @!method initialize(access_programs: nil, background: nil, context_management: nil, conversation: nil, generate: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
           #   Client event for creating a response over a persistent WebSocket connection.
           #   This payload uses the same top-level fields as `POST /v1/responses`, plus
           #   WebSocket-only envelope metadata.
@@ -490,6 +498,11 @@ module OpenAI
           #     items from this response are automatically added to this conversation after this
           #     response completes.
           #
+          #   @param generate [Boolean]
+          #     Whether to generate output for this response. Defaults to true when omitted. Set
+          #     to false to prepare request state without model output; the response ID can be
+          #     used as previous_response_id on a later turn.
+          #
           #   @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>, nil]
           #     Specify additional output data to include in the model response. Currently
           #     supported values are:

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

@@ -636,8 +636,8 @@ module OpenAI
           # @!attribute input_fidelity
           #   Control how much effort the model will exert to match the style and features,
           #   especially facial features, of input images. Supports `high` and `low` on
-          #   `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          #   `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          #   this parameter. Defaults to `low` on supported models.
           #
           #   @return [Symbol, OpenAI::Models::Responses::Tool::ImageGeneration::InputFidelity, nil]
           optional(
@@ -738,8 +738,8 @@ module OpenAI
           #   @param input_fidelity [Symbol, OpenAI::Models::Responses::Tool::ImageGeneration::InputFidelity, nil]
           #     Control how much effort the model will exert to match the style and features,
           #     especially facial features, of input images. Supports `high` and `low` on
-          #     `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          #     `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          #     `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          #     this parameter. Defaults to `low` on supported models.
           #
           #   @param input_image_mask [OpenAI::Models::Responses::Tool::ImageGeneration::InputImageMask]
           #     Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -828,8 +828,8 @@ module OpenAI
 
           # Control how much effort the model will exert to match the style and features,
           # especially facial features, of input images. Supports `high` and `low` on
-          # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          # this parameter. Defaults to `low` on supported models.
           #
           # @see OpenAI::Models::Responses::Tool::ImageGeneration#input_fidelity
           module InputFidelity

data/lib/openai/net_http_client.rb

@@ -355,5 +355,11 @@ module OpenAI
       @connection_configurator = connection_configurator
       @pools = {}
     end
+
+    # Whether this HTTP client has the same connection policy as the SDK default.
+    # @api private
+    def default_configuration?
+      @size == DEFAULT_MAX_CONNECTIONS && @connection_configurator.nil?
+    end
   end
 end

data/lib/openai/providers/vertex.rb

@@ -116,15 +116,6 @@ module OpenAI
               if headers.key?("api-key")
                 raise OpenAI::Errors::Error, "Vertex authentication cannot be combined with a custom api-key header."
               end
-              # The outer Google API version differs for stored Responses.
-              # Do not change other gateway layouts.
-              prefix = "#{base.path.delete_suffix("/")}/responses/"
-              if [:get, :delete].include?(request[:method]) &&
-                  url.path.start_with?(prefix) &&
-                  base.path.start_with?("/v1/projects/")
-                url = url.dup
-                url.path = url.path.sub(%r{\A/v1/}, "/v1beta1/")
-              end
 
               headers.delete("openai-organization")
               headers.delete("openai-project")
@@ -163,7 +154,6 @@ module OpenAI
               context[:token] = token if context
 
               request.merge(
-                url: url,
                 timeout: remaining,
                 headers: headers.merge("authorization" => "Bearer #{token}"),
                 provider_auth: AUTH_MARKER,

data/lib/openai/resources/admin/organization/external_keys.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class ExternalKeys
+          # Add an external key config for an organization
+          #
+          # @overload create(body:, request_options: {})
+          #
+          # @param body [OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Aws, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Gcp, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Azure]
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::ExternalKey]
+          #
+          # @see OpenAI::Models::Admin::Organization::ExternalKeyCreateParams
+          def create(params)
+            parsed, options = OpenAI::Admin::Organization::ExternalKeyCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "organization/external_keys",
+              body: parsed[:body],
+              model: OpenAI::Admin::Organization::ExternalKey,
+              security: {admin_api_key_auth: true},
+              options: options
+            )
+          end
+
+          # Retrieve a stored external key registration for the user's organization.
+          #
+          # @overload retrieve(external_key_id, request_options: {})
+          #
+          # @param external_key_id [String]
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::ExternalKey]
+          #
+          # @see OpenAI::Models::Admin::Organization::ExternalKeyRetrieveParams
+          def retrieve(external_key_id, params = {})
+            @client.request(
+              method: :get,
+              path: ["organization/external_keys/%1$s", external_key_id],
+              model: OpenAI::Admin::Organization::ExternalKey,
+              security: {admin_api_key_auth: true},
+              options: params[:request_options]
+            )
+          end
+
+          # List the external key configs registered on the user's organization
+          #
+          # @overload list(after: nil, limit: nil, order: nil, purpose: nil, request_options: {})
+          #
+          # @param after [String, nil]
+          #
+          # @param limit [Integer]
+          #
+          # @param order [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyListParams::Order]
+          #
+          # @param purpose [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyListParams::Purpose]
+          #   Filter by key purpose. When omitted, returns keys of all purposes.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Admin::Organization::ExternalKey>]
+          #
+          # @see OpenAI::Models::Admin::Organization::ExternalKeyListParams
+          def list(params = {})
+            parsed, options = OpenAI::Admin::Organization::ExternalKeyListParams.dump_request(params)
+            query = OpenAI::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "organization/external_keys",
+              query: query,
+              page: OpenAI::Internal::CursorPage,
+              model: OpenAI::Admin::Organization::ExternalKey,
+              security: {admin_api_key_auth: true},
+              options: options
+            )
+          end
+
+          # Delete an external key config for the user's organization
+          #
+          # @overload delete(external_key_id, request_options: {})
+          #
+          # @param external_key_id [String]
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::ExternalKey]
+          #
+          # @see OpenAI::Models::Admin::Organization::ExternalKeyDeleteParams
+          def delete(external_key_id, params = {})
+            @client.request(
+              method: :delete,
+              path: ["organization/external_keys/%1$s", external_key_id],
+              model: OpenAI::Admin::Organization::ExternalKey,
+              security: {admin_api_key_auth: true},
+              options: params[:request_options]
+            )
+          end
+
+          # Validate an external key config for the user's organization
+          #
+          # @overload validate(external_key_id, request_options: {})
+          #
+          # @param external_key_id [String]
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::ExternalKeyValidateResponse]
+          #
+          # @see OpenAI::Models::Admin::Organization::ExternalKeyValidateParams
+          def validate(external_key_id, params = {})
+            @client.request(
+              method: :post,
+              path: ["organization/external_keys/%1$s/validate", external_key_id],
+              model: OpenAI::Models::Admin::Organization::ExternalKeyValidateResponse,
+              security: {admin_api_key_auth: true},
+              options: params[:request_options]
+            )
+          end
+
+          # @api private
+          #
+          # @param client [OpenAI::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/admin/organization.rb

@@ -29,6 +29,9 @@ module OpenAI
         # @return [OpenAI::Resources::Admin::Organization::DataRetention]
         attr_reader :data_retention
 
+        # @return [OpenAI::Resources::Admin::Organization::ExternalKeys]
+        attr_reader :external_keys
+
         # @return [OpenAI::Resources::Admin::Organization::ExternalStorage]
         attr_reader :external_storage
 
@@ -57,6 +60,7 @@ module OpenAI
           @groups = OpenAI::Resources::Admin::Organization::Groups.new(client: client)
           @roles = OpenAI::Resources::Admin::Organization::Roles.new(client: client)
           @data_retention = OpenAI::Resources::Admin::Organization::DataRetention.new(client: client)
+          @external_keys = OpenAI::Resources::Admin::Organization::ExternalKeys.new(client: client)
           @external_storage = OpenAI::Resources::Admin::Organization::ExternalStorage.new(client: client)
           @spend_limit = OpenAI::Resources::Admin::Organization::SpendLimit.new(client: client)
           @spend_alerts = OpenAI::Resources::Admin::Organization::SpendAlerts.new(client: client)

data/lib/openai/resources/audio/speech.rb

@@ -9,6 +9,14 @@ module OpenAI
         #
         # Returns the audio file content, or a stream of audio events.
         #
+        # The `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, `gpt-4o-mini-tts-2025-03-20`, and
+        # `gpt-4o-mini-tts-2025-12-15` models are deprecated and scheduled to shut down on
+        # January 6, 2027. These examples use the existing Speech API; for new
+        # integrations, migrate to `gpt-realtime-2.1-mini` through the
+        # [Realtime API](https://developers.openai.com/api/docs/guides/realtime). See the
+        # [deprecation schedule](https://developers.openai.com/api/docs/deprecations) for
+        # migration details.
+        #
         # @overload create(input:, model:, voice:, instructions: nil, response_format: nil, speed: nil, stream_format: nil, request_options: {})
         #
         # @param input [String]

data/lib/openai/resources/audio/translations.rb

@@ -5,8 +5,16 @@ module OpenAI
     class Audio
       # Turn audio into text or text into audio.
       class Translations
+        # @deprecated
+        #
         # Translates audio into English.
         #
+        # This endpoint supports only `whisper-1`. The endpoint and model are deprecated
+        # and scheduled to shut down on February 26, 2027. Migrate to
+        # `/v1/realtime/translations`, which requires a separate integration. See the
+        # [deprecation schedule](https://developers.openai.com/api/docs/deprecations) for
+        # details.
+        #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.

data/lib/openai/resources/beta/agents/sessions.rb

@@ -32,7 +32,7 @@ module OpenAI
           # the session or streams its events when stream is true. See
           # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
           #
-          # @overload create(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, spend_control: nil, vault_ids: nil, request_options: {})
+          # @overload create(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, review: nil, spend_control: nil, vault_ids: nil, request_options: {})
           #
           # @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
           #   An inline execution environment or a reference to an environment template.
@@ -55,6 +55,9 @@ module OpenAI
           #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #   characters. Omission or null defaults to an empty map.
           #
+          # @param review [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::Review]
+          #   Action review mode. Omit to use none.
+          #
           # @param spend_control [OpenAI::Models::Beta::Agents::SessionCreateParams::SpendControl, nil]
           #   Optional spending limit in USD cents. Omission or null creates an unlimited
           #   session.
@@ -92,7 +95,7 @@ module OpenAI
           # the session or streams its events when stream is true. See
           # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
           #
-          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, tool_handlers: {}, metadata: nil, spend_control: nil, vault_ids: nil, request_options: {})
+          # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, tool_handlers: {}, metadata: nil, review: nil, spend_control: nil, vault_ids: nil, request_options: {})
           #
           # @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
           #   An inline execution environment or a reference to an environment template.
@@ -115,6 +118,9 @@ module OpenAI
           #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #   characters. Omission or null defaults to an empty map.
           #
+          # @param review [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::Review]
+          #   Action review mode. Omit to use none.
+          #
           # @param spend_control [OpenAI::Models::Beta::Agents::SessionCreateParams::SpendControl, nil]
           #   Optional spending limit in USD cents. Omission or null creates an unlimited
           #   session.
@@ -188,23 +194,27 @@ module OpenAI
             )
           end
 
-          # Updates session metadata, model, reasoning effort, or service tier. Model
+          # Updates session tools, metadata, model, reasoning effort, or service tier. Model
           # settings apply to subsequent turns. Omitted fields are unchanged. See
           # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
           #
-          # @overload update(session_id, agent: nil, metadata: nil, spend_control: nil, request_options: {})
+          # @overload update(session_id, agent: nil, metadata: nil, review: nil, spend_control: nil, request_options: {})
           #
           # @param session_id [String]
           #   The ID of the session.
           #
           # @param agent [OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent]
-          #   Model settings for subsequent turns. Omitted fields stay unchanged.
+          #   Agent settings to update on this session. Omitted fields stay unchanged.
           #
           # @param metadata [Hash{Symbol=>String}, nil]
           #   Replaces all metadata. Omit to leave unchanged, or pass null or {} to clear it.
           #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #   characters.
           #
+          # @param review [Symbol, OpenAI::Models::Beta::Agents::SessionUpdateParams::Review]
+          #   Default action review for new root turns. Existing turns and their subagents
+          #   keep their review mode.
+          #
           # @param spend_control [OpenAI::Models::Beta::Agents::SessionUpdateParams::SpendControl, nil]
           #   Omit to retain the limit; null or a null limit removes it without resetting
           #   spend.
@@ -231,7 +241,7 @@ module OpenAI
           # order. See
           # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
           #
-          # @overload list(after: nil, agent_id: nil, limit: nil, order: nil, request_options: {})
+          # @overload list(after: nil, agent_id: nil, limit: nil, metadata: nil, order: nil, request_options: {})
           #
           # @param after [String]
           #   Return resources after this resource ID in the selected order.
@@ -243,6 +253,12 @@ module OpenAI
           # @param limit [Integer]
           #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
           #
+          # @param metadata [Hash{Symbol=>String}]
+          #   Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+          #   match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+          #   characters. New sessions and metadata updates may take time to appear in
+          #   filtered results.
+          #
           # @param order [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order]
           #   The order in which resources are returned. Defaults to `desc`.
           #