openai 0.23.2 → 0.23.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7603886aae923da50eb83881be4d69cf1b5be3616b9903a784f16bcd124c023d
-  data.tar.gz: 03feb2933c7a27590301dc9c805d66ce2e7f45e743515e7e46bf9bbf9d61dfe3
+  metadata.gz: 78de67c6327d605033609ccd07e0d74abf3435c29fca8a16814e47bb9a3adccb
+  data.tar.gz: 5acaec7441b93b103201e5b5f9848537f6e61126baaaffaf468073a063970d48
 SHA512:
-  metadata.gz: 6de05c188535d0ed867bf936a6e97a7f452bd6924678b672d23f7868feeda7144df86dac454bfa29300d81844799c1ab77adc42767a314975d566acacb3aaefd
-  data.tar.gz: bf693ec699be028060d13db1fa9bd5ef3bb980118d5c4b292877bc6a16a88bd743ee10cd6c6a9d3828aa15d31e8e55058d660d831af3179050c68b110d8c705f
+  metadata.gz: 0c3830e5b495692fa49be0fb6f23da597a75f08c376105e98fd7ede52ec06374dbb4e0234739edf2c355f7a76a8e8d77a858dbce211d512f74bddc818717e47e
+  data.tar.gz: 751b22f53a5176438c4a8ee65a67393860ebecd282b8847fc50b0a9ccfe1c39ecc9940c501cb51f2e67ff8746816ff385f3d2721a527533c02e95ab0cc1eaf2d

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.23.3 (2025-09-15)
+
+Full Changelog: [v0.23.2...v0.23.3](https://github.com/openai/openai-ruby/compare/v0.23.2...v0.23.3)
+
+### Chores
+
+* **api:** docs and spec refactoring ([81ccb86](https://github.com/openai/openai-ruby/commit/81ccb86c346e51a2b5d532a5997358aa86977572))
+
 ## 0.23.2 (2025-09-11)
 
 Full Changelog: [v0.23.1...v0.23.2](https://github.com/openai/openai-ruby/compare/v0.23.1...v0.23.2)

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.23.2"
+gem "openai", "~> 0.23.3"
 ```
 
 <!-- x-release-please-end -->

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

@@ -21,9 +21,12 @@ module OpenAI
         optional :limit, Integer
 
         # @!attribute metadata
-        #   A list of metadata keys to filter the Chat Completions by. Example:
+        #   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.
         #
-        #   `metadata[key1]=value1&metadata[key2]=value2`
+        #   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]
         optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
@@ -49,7 +52,7 @@ module OpenAI
         #
         #   @param limit [Integer] Number of Chat Completions to retrieve.
         #
-        #   @param metadata [Hash{Symbol=>String}, nil] A list of metadata keys to filter the Chat Completions by. Example:
+        #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
         #
         #   @param model [String] The model used to generate the Chat Completions.
         #

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

@@ -18,8 +18,12 @@ module OpenAI
                  nil?: true
 
         # @!attribute metadata
-        #   Set of 16 key-value pairs that can be attached to an object. Useful for storing
-        #   additional information about the object in a structured format.
+        #   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.
         #
         #   @return [Hash{Symbol=>String}, nil]
         optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
@@ -30,7 +34,7 @@ module OpenAI
         #
         #   @param items [Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference>, nil] Initial items to include in the conversation context.
         #
-        #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. Useful for
+        #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openai/models/evals/run_cancel_response.rb

@@ -314,8 +314,11 @@ module OpenAI
                 optional :model, String, nil?: true
 
                 # @!attribute reasoning_effort
-                #   Optional reasoning effort parameter. This is a query parameter used to select
-                #   responses.
+                #   Constrains effort on reasoning for
+                #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                #   supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                #   effort can result in faster responses and fewer tokens used on reasoning in a
+                #   response.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -361,7 +364,7 @@ module OpenAI
                 #
                 #   @param model [String, nil] The name of the model to find responses for. This is a query parameter used to s
                 #
-                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Optional reasoning effort parameter. This is a query parameter used to select re
+                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
                 #
                 #   @param temperature [Float, nil] Sampling temperature. This is a query parameter used to select responses.
                 #

data/lib/openai/models/evals/run_create_params.rb

@@ -226,8 +226,11 @@ module OpenAI
                 optional :model, String, nil?: true
 
                 # @!attribute reasoning_effort
-                #   Optional reasoning effort parameter. This is a query parameter used to select
-                #   responses.
+                #   Constrains effort on reasoning for
+                #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                #   supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                #   effort can result in faster responses and fewer tokens used on reasoning in a
+                #   response.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -273,7 +276,7 @@ module OpenAI
                 #
                 #   @param model [String, nil] The name of the model to find responses for. This is a query parameter used to s
                 #
-                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Optional reasoning effort parameter. This is a query parameter used to select re
+                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
                 #
                 #   @param temperature [Float, nil] Sampling temperature. This is a query parameter used to select responses.
                 #

data/lib/openai/models/evals/run_create_response.rb

@@ -314,8 +314,11 @@ module OpenAI
                 optional :model, String, nil?: true
 
                 # @!attribute reasoning_effort
-                #   Optional reasoning effort parameter. This is a query parameter used to select
-                #   responses.
+                #   Constrains effort on reasoning for
+                #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                #   supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                #   effort can result in faster responses and fewer tokens used on reasoning in a
+                #   response.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -361,7 +364,7 @@ module OpenAI
                 #
                 #   @param model [String, nil] The name of the model to find responses for. This is a query parameter used to s
                 #
-                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Optional reasoning effort parameter. This is a query parameter used to select re
+                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
                 #
                 #   @param temperature [Float, nil] Sampling temperature. This is a query parameter used to select responses.
                 #

data/lib/openai/models/evals/run_list_response.rb

@@ -314,8 +314,11 @@ module OpenAI
                 optional :model, String, nil?: true
 
                 # @!attribute reasoning_effort
-                #   Optional reasoning effort parameter. This is a query parameter used to select
-                #   responses.
+                #   Constrains effort on reasoning for
+                #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                #   supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                #   effort can result in faster responses and fewer tokens used on reasoning in a
+                #   response.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -361,7 +364,7 @@ module OpenAI
                 #
                 #   @param model [String, nil] The name of the model to find responses for. This is a query parameter used to s
                 #
-                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Optional reasoning effort parameter. This is a query parameter used to select re
+                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
                 #
                 #   @param temperature [Float, nil] Sampling temperature. This is a query parameter used to select responses.
                 #

data/lib/openai/models/evals/run_retrieve_response.rb

@@ -314,8 +314,11 @@ module OpenAI
                 optional :model, String, nil?: true
 
                 # @!attribute reasoning_effort
-                #   Optional reasoning effort parameter. This is a query parameter used to select
-                #   responses.
+                #   Constrains effort on reasoning for
+                #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                #   supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                #   effort can result in faster responses and fewer tokens used on reasoning in a
+                #   response.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -361,7 +364,7 @@ module OpenAI
                 #
                 #   @param model [String, nil] The name of the model to find responses for. This is a query parameter used to s
                 #
-                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Optional reasoning effort parameter. This is a query parameter used to select re
+                #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
                 #
                 #   @param temperature [Float, nil] Sampling temperature. This is a query parameter used to select responses.
                 #

data/lib/openai/resources/chat/completions.rb

@@ -387,7 +387,7 @@ module OpenAI
         #
         # @param limit [Integer] Number of Chat Completions to retrieve.
         #
-        # @param metadata [Hash{Symbol=>String}, nil] A list of metadata keys to filter the Chat Completions by. Example:
+        # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
         #
         # @param model [String] The model used to generate the Chat Completions.
         #

data/lib/openai/resources/conversations.rb

@@ -15,7 +15,7 @@ module OpenAI
       #
       # @param items [Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference>, nil] Initial items to include in the conversation context.
       #
-      # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. Useful for
+      # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/openai/version.rb

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

data/rbi/openai/models/chat/completion_list_params.rbi

@@ -26,9 +26,12 @@ module OpenAI
         sig { params(limit: Integer).void }
         attr_writer :limit
 
-        # A list of metadata keys to filter the Chat Completions by. Example:
+        # 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.
         #
-        # `metadata[key1]=value1&metadata[key2]=value2`
+        # Keys are strings with a maximum length of 64 characters. Values are strings with
+        # a maximum length of 512 characters.
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_accessor :metadata
 
@@ -70,9 +73,12 @@ module OpenAI
           after: nil,
           # Number of Chat Completions to retrieve.
           limit: nil,
-          # A list of metadata keys to filter the Chat Completions by. Example:
+          # 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.
           #
-          # `metadata[key1]=value1&metadata[key2]=value2`
+          # Keys are strings with a maximum length of 64 characters. Values are strings with
+          # a maximum length of 512 characters.
           metadata: nil,
           # The model used to generate the Chat Completions.
           model: nil,

data/rbi/openai/models/conversations/conversation_create_params.rbi

@@ -50,8 +50,12 @@ module OpenAI
         end
         attr_accessor :items
 
-        # Set of 16 key-value pairs that can be attached to an object. Useful for storing
-        # additional information about the object in a structured format.
+        # 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.
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_accessor :metadata
 
@@ -93,8 +97,12 @@ module OpenAI
           # Initial items to include in the conversation context. You may add up to 20 items
           # at a time.
           items: nil,
-          # Set of 16 key-value pairs that can be attached to an object. Useful for storing
-          # additional information about the object in a structured format.
+          # 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.
           metadata: nil,
           request_options: {}
         )

data/rbi/openai/models/evals/run_cancel_response.rbi

@@ -510,8 +510,11 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :model
 
-                # Optional reasoning effort parameter. This is a query parameter used to select
-                # responses.
+                # Constrains effort on reasoning for
+                # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                # effort can result in faster responses and fewer tokens used on reasoning in a
+                # response.
                 sig do
                   returns(T.nilable(OpenAI::ReasoningEffort::TaggedSymbol))
                 end
@@ -566,8 +569,11 @@ module OpenAI
                   # The name of the model to find responses for. This is a query parameter used to
                   # select responses.
                   model: nil,
-                  # Optional reasoning effort parameter. This is a query parameter used to select
-                  # responses.
+                  # Constrains effort on reasoning for
+                  # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                  # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                  # effort can result in faster responses and fewer tokens used on reasoning in a
+                  # response.
                   reasoning_effort: nil,
                   # Sampling temperature. This is a query parameter used to select responses.
                   temperature: nil,

data/rbi/openai/models/evals/run_create_params.rbi

@@ -420,8 +420,11 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :model
 
-                # Optional reasoning effort parameter. This is a query parameter used to select
-                # responses.
+                # Constrains effort on reasoning for
+                # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                # effort can result in faster responses and fewer tokens used on reasoning in a
+                # response.
                 sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
                 attr_accessor :reasoning_effort
 
@@ -474,8 +477,11 @@ module OpenAI
                   # The name of the model to find responses for. This is a query parameter used to
                   # select responses.
                   model: nil,
-                  # Optional reasoning effort parameter. This is a query parameter used to select
-                  # responses.
+                  # Constrains effort on reasoning for
+                  # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                  # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                  # effort can result in faster responses and fewer tokens used on reasoning in a
+                  # response.
                   reasoning_effort: nil,
                   # Sampling temperature. This is a query parameter used to select responses.
                   temperature: nil,

data/rbi/openai/models/evals/run_create_response.rbi

@@ -510,8 +510,11 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :model
 
-                # Optional reasoning effort parameter. This is a query parameter used to select
-                # responses.
+                # Constrains effort on reasoning for
+                # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                # effort can result in faster responses and fewer tokens used on reasoning in a
+                # response.
                 sig do
                   returns(T.nilable(OpenAI::ReasoningEffort::TaggedSymbol))
                 end
@@ -566,8 +569,11 @@ module OpenAI
                   # The name of the model to find responses for. This is a query parameter used to
                   # select responses.
                   model: nil,
-                  # Optional reasoning effort parameter. This is a query parameter used to select
-                  # responses.
+                  # Constrains effort on reasoning for
+                  # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                  # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                  # effort can result in faster responses and fewer tokens used on reasoning in a
+                  # response.
                   reasoning_effort: nil,
                   # Sampling temperature. This is a query parameter used to select responses.
                   temperature: nil,

data/rbi/openai/models/evals/run_list_response.rbi

@@ -506,8 +506,11 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :model
 
-                # Optional reasoning effort parameter. This is a query parameter used to select
-                # responses.
+                # Constrains effort on reasoning for
+                # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                # effort can result in faster responses and fewer tokens used on reasoning in a
+                # response.
                 sig do
                   returns(T.nilable(OpenAI::ReasoningEffort::TaggedSymbol))
                 end
@@ -562,8 +565,11 @@ module OpenAI
                   # The name of the model to find responses for. This is a query parameter used to
                   # select responses.
                   model: nil,
-                  # Optional reasoning effort parameter. This is a query parameter used to select
-                  # responses.
+                  # Constrains effort on reasoning for
+                  # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                  # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                  # effort can result in faster responses and fewer tokens used on reasoning in a
+                  # response.
                   reasoning_effort: nil,
                   # Sampling temperature. This is a query parameter used to select responses.
                   temperature: nil,

data/rbi/openai/models/evals/run_retrieve_response.rbi

@@ -512,8 +512,11 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :model
 
-                # Optional reasoning effort parameter. This is a query parameter used to select
-                # responses.
+                # Constrains effort on reasoning for
+                # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                # effort can result in faster responses and fewer tokens used on reasoning in a
+                # response.
                 sig do
                   returns(T.nilable(OpenAI::ReasoningEffort::TaggedSymbol))
                 end
@@ -568,8 +571,11 @@ module OpenAI
                   # The name of the model to find responses for. This is a query parameter used to
                   # select responses.
                   model: nil,
-                  # Optional reasoning effort parameter. This is a query parameter used to select
-                  # responses.
+                  # Constrains effort on reasoning for
+                  # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+                  # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+                  # effort can result in faster responses and fewer tokens used on reasoning in a
+                  # response.
                   reasoning_effort: nil,
                   # Sampling temperature. This is a query parameter used to select responses.
                   temperature: nil,

data/rbi/openai/resources/chat/completions.rbi

@@ -699,9 +699,12 @@ module OpenAI
           after: nil,
           # Number of Chat Completions to retrieve.
           limit: nil,
-          # A list of metadata keys to filter the Chat Completions by. Example:
+          # 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.
           #
-          # `metadata[key1]=value1&metadata[key2]=value2`
+          # Keys are strings with a maximum length of 64 characters. Values are strings with
+          # a maximum length of 512 characters.
           metadata: nil,
           # The model used to generate the Chat Completions.
           model: nil,

data/rbi/openai/resources/conversations.rbi

@@ -45,8 +45,12 @@ module OpenAI
         # Initial items to include in the conversation context. You may add up to 20 items
         # at a time.
         items: nil,
-        # Set of 16 key-value pairs that can be attached to an object. Useful for storing
-        # additional information about the object in a structured format.
+        # 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.
         metadata: nil,
         request_options: {}
       )

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openai
 version: !ruby/object:Gem::Version
-  version: 0.23.2
+  version: 0.23.3
 platform: ruby
 authors:
 - OpenAI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-12 00:00:00.000000000 Z
+date: 2025-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool