chore(api): docs and spec refactoring

stainless-app[bot] · stainless-app[bot] · commit 81ccb86c346e · 2025-09-15T19:52:49.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 118
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-94b1e3cb0bdc616ff0c2f267c33dadd95f133b1f64e647aab6c64afb292b2793.yml
-openapi_spec_hash: 2395319ac9befd59b6536ae7f9564a05
-config_hash: 930dac3aa861344867e4ac84f037b5df
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-d30ff992a48873c1466c49f3c01f2ec8933faebff23424748f8d056065b1bcef.yml
+openapi_spec_hash: e933ec43b46f45c348adb78840e5808d
+config_hash: bf45940f0a7805b4ec2017eecdd36893
diff --git a/lib/openai/models/chat/completion_list_params.rb b/lib/openai/models/chat/completion_list_params.rb
@@ -21,9 +21,12 @@ class CompletionListParams < OpenAI::Internal::Type::BaseModel
         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 @@ class CompletionListParams < OpenAI::Internal::Type::BaseModel
         #
         #   @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.
         #
diff --git a/lib/openai/models/conversations/conversation_create_params.rb b/lib/openai/models/conversations/conversation_create_params.rb
@@ -18,8 +18,12 @@ class ConversationCreateParams < OpenAI::Internal::Type::BaseModel
                  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 @@ class ConversationCreateParams < OpenAI::Internal::Type::BaseModel
         #
         #   @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
diff --git a/lib/openai/models/evals/run_cancel_response.rb b/lib/openai/models/evals/run_cancel_response.rb
@@ -314,8 +314,11 @@ class Responses < OpenAI::Internal::Type::BaseModel
                 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 @@ class Responses < OpenAI::Internal::Type::BaseModel
                 #
                 #   @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.
                 #
diff --git a/lib/openai/models/evals/run_create_params.rb b/lib/openai/models/evals/run_create_params.rb
@@ -226,8 +226,11 @@ class Responses < OpenAI::Internal::Type::BaseModel
                 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 @@ class Responses < OpenAI::Internal::Type::BaseModel
                 #
                 #   @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.
                 #
diff --git a/lib/openai/models/evals/run_create_response.rb b/lib/openai/models/evals/run_create_response.rb
@@ -314,8 +314,11 @@ class Responses < OpenAI::Internal::Type::BaseModel
                 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 @@ class Responses < OpenAI::Internal::Type::BaseModel
                 #
                 #   @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.
                 #
diff --git a/lib/openai/models/evals/run_list_response.rb b/lib/openai/models/evals/run_list_response.rb
@@ -314,8 +314,11 @@ class Responses < OpenAI::Internal::Type::BaseModel
                 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 @@ class Responses < OpenAI::Internal::Type::BaseModel
                 #
                 #   @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.
                 #
diff --git a/lib/openai/models/evals/run_retrieve_response.rb b/lib/openai/models/evals/run_retrieve_response.rb
@@ -314,8 +314,11 @@ class Responses < OpenAI::Internal::Type::BaseModel
                 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 @@ class Responses < OpenAI::Internal::Type::BaseModel
                 #
                 #   @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.
                 #
diff --git a/lib/openai/resources/chat/completions.rb b/lib/openai/resources/chat/completions.rb
@@ -387,7 +387,7 @@ def update(completion_id, params)
         #
         # @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.
         #
diff --git a/lib/openai/resources/conversations.rb b/lib/openai/resources/conversations.rb
@@ -15,7 +15,7 @@ class Conversations
       #
       # @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]
       #
diff --git a/rbi/openai/models/chat/completion_list_params.rbi b/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,
diff --git a/rbi/openai/models/conversations/conversation_create_params.rbi b/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: {}
         )
diff --git a/rbi/openai/models/evals/run_cancel_response.rbi b/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,
diff --git a/rbi/openai/models/evals/run_create_params.rbi b/rbi/openai/models/evals/run_create_params.rbi
diff --git a/rbi/openai/models/evals/run_create_response.rbi b/rbi/openai/models/evals/run_create_response.rbi
diff --git a/rbi/openai/models/evals/run_list_response.rbi b/rbi/openai/models/evals/run_list_response.rbi
diff --git a/rbi/openai/models/evals/run_retrieve_response.rbi b/rbi/openai/models/evals/run_retrieve_response.rbi
diff --git a/rbi/openai/resources/chat/completions.rbi b/rbi/openai/resources/chat/completions.rbi
diff --git a/rbi/openai/resources/conversations.rbi b/rbi/openai/resources/conversations.rbi

Original file line number	Diff line number	Diff line change
`@@ -21,9 +21,12 @@ class CompletionListParams < OpenAI::Internal::Type::BaseModel`
`21`	`21`	`optional :limit, Integer`
`22`	`22`
`23`	`23`	`# @!attribute metadata`
`24`		`- # A list of metadata keys to filter the Chat Completions by. Example:`
	`24`	`+ # Set of 16 key-value pairs that can be attached to an object. This can be useful`
	`25`	`+ # for storing additional information about the object in a structured format, and`
	`26`	`+ # querying for objects via API or the dashboard.`
`25`	`27`	`#`
`26`		- # `metadata[key1]=value1&metadata[key2]=value2`
	`28`	`+ # Keys are strings with a maximum length of 64 characters. Values are strings with`
	`29`	`+ # a maximum length of 512 characters.`
`27`	`30`	`#`
`28`	`31`	`# @return [Hash{Symbol=>String}, nil]`
`29`	`32`	`optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true`
`@@ -49,7 +52,7 @@ class CompletionListParams < OpenAI::Internal::Type::BaseModel`
`49`	`52`	`#`
`50`	`53`	`# @param limit [Integer] Number of Chat Completions to retrieve.`
`51`	`54`	`#`
`52`		`- # @param metadata [Hash{Symbol=>String}, nil] A list of metadata keys to filter the Chat Completions by. Example:`
	`55`	`+ # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be`
`53`	`56`	`#`
`54`	`57`	`# @param model [String] The model used to generate the Chat Completions.`
`55`	`58`	`#`
Original file line number	Diff line number	Diff line change
`@@ -18,8 +18,12 @@ class ConversationCreateParams < OpenAI::Internal::Type::BaseModel`
`18`	`18`	`nil?: true`
`19`	`19`
`20`	`20`	`# @!attribute metadata`
`21`		`- # Set of 16 key-value pairs that can be attached to an object. Useful for storing`
`22`		`- # additional information about the object in a structured format.`
	`21`	`+ # Set of 16 key-value pairs that can be attached to an object. This can be useful`
	`22`	`+ # for storing additional information about the object in a structured format, and`
	`23`	`+ # querying for objects via API or the dashboard.`
	`24`	`+ #`
	`25`	`+ # Keys are strings with a maximum length of 64 characters. Values are strings with`
	`26`	`+ # a maximum length of 512 characters.`
`23`	`27`	`#`
`24`	`28`	`# @return [Hash{Symbol=>String}, nil]`
`25`	`29`	`optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true`
`@@ -30,7 +34,7 @@ class ConversationCreateParams < OpenAI::Internal::Type::BaseModel`
`30`	`34`	`#`
`31`	`35`	# @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.
`32`	`36`	`#`
`33`		`- # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. Useful for`
	`37`	`+ # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be`
`34`	`38`	`#`
`35`	`39`	`# @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]`
`36`	`40`	`end`
Original file line number	Diff line number	Diff line change
`@@ -314,8 +314,11 @@ class Responses < OpenAI::Internal::Type::BaseModel`
`314`	`314`	`optional :model, String, nil?: true`
`315`	`315`
`316`	`316`	`# @!attribute reasoning_effort`
`317`		`- # Optional reasoning effort parameter. This is a query parameter used to select`
`318`		`- # responses.`
	`317`	`+ # Constrains effort on reasoning for`
	`318`	`+ # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently`
	`319`	+ # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
	`320`	`+ # effort can result in faster responses and fewer tokens used on reasoning in a`
	`321`	`+ # response.`
`319`	`322`	`#`
`320`	`323`	`# @return [Symbol, OpenAI::Models::ReasoningEffort, nil]`
`321`	`324`	`optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true`
`@@ -361,7 +364,7 @@ class Responses < OpenAI::Internal::Type::BaseModel`
`361`	`364`	`#`
`362`	`365`	`# @param model [String, nil] The name of the model to find responses for. This is a query parameter used to s`
`363`	`366`	`#`
`364`		`- # @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Optional reasoning effort parameter. This is a query parameter used to select re`
	`367`	`+ # @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for`
`365`	`368`	`#`
`366`	`369`	`# @param temperature [Float, nil] Sampling temperature. This is a query parameter used to select responses.`
`367`	`370`	`#`
Original file line number	Diff line number	Diff line change
`@@ -226,8 +226,11 @@ class Responses < OpenAI::Internal::Type::BaseModel`
`226`	`226`	`optional :model, String, nil?: true`
`227`	`227`
`228`	`228`	`# @!attribute reasoning_effort`
`229`		`- # Optional reasoning effort parameter. This is a query parameter used to select`
`230`		`- # responses.`
	`229`	`+ # Constrains effort on reasoning for`
	`230`	`+ # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently`
	`231`	+ # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
	`232`	`+ # effort can result in faster responses and fewer tokens used on reasoning in a`
	`233`	`+ # response.`
`231`	`234`	`#`
`232`	`235`	`# @return [Symbol, OpenAI::Models::ReasoningEffort, nil]`
`233`	`236`	`optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true`
`@@ -273,7 +276,7 @@ class Responses < OpenAI::Internal::Type::BaseModel`
`273`	`276`	`#`
`274`	`277`	`# @param model [String, nil] The name of the model to find responses for. This is a query parameter used to s`
`275`	`278`	`#`
`276`		`- # @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Optional reasoning effort parameter. This is a query parameter used to select re`
	`279`	`+ # @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for`
`277`	`280`	`#`
`278`	`281`	`# @param temperature [Float, nil] Sampling temperature. This is a query parameter used to select responses.`
`279`	`282`	`#`
Original file line number	Diff line number	Diff line change
`@@ -387,7 +387,7 @@ def update(completion_id, params)`
`387`	`387`	`#`
`388`	`388`	`# @param limit [Integer] Number of Chat Completions to retrieve.`
`389`	`389`	`#`
`390`		`- # @param metadata [Hash{Symbol=>String}, nil] A list of metadata keys to filter the Chat Completions by. Example:`
	`390`	`+ # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be`
`391`	`391`	`#`
`392`	`392`	`# @param model [String] The model used to generate the Chat Completions.`
`393`	`393`	`#`
Original file line number	Diff line number	Diff line change
`@@ -15,7 +15,7 @@ class Conversations`
`15`	`15`	`#`
`16`	`16`	# @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.
`17`	`17`	`#`
`18`		`- # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. Useful for`
	`18`	`+ # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be`
`19`	`19`	`#`
`20`	`20`	`# @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]`
`21`	`21`	`#`