openai 0.71.0 → 0.72.0

data/rbi/openai/models/admin/organization/spend_limit_update_params.rbi

@@ -0,0 +1,141 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        class SpendLimitUpdateParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Admin::Organization::SpendLimitUpdateParams,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The currency for the threshold amount. Currently, only `USD` is supported.
+          sig do
+            returns(
+              OpenAI::Admin::Organization::SpendLimitUpdateParams::Currency::OrSymbol
+            )
+          end
+          attr_accessor :currency
+
+          # The time interval for evaluating spend against the threshold. Currently, only
+          # `month` is supported.
+          sig do
+            returns(
+              OpenAI::Admin::Organization::SpendLimitUpdateParams::Interval::OrSymbol
+            )
+          end
+          attr_accessor :interval
+
+          # The hard spend limit amount, in cents.
+          sig { returns(Integer) }
+          attr_accessor :threshold_amount
+
+          sig do
+            params(
+              currency:
+                OpenAI::Admin::Organization::SpendLimitUpdateParams::Currency::OrSymbol,
+              interval:
+                OpenAI::Admin::Organization::SpendLimitUpdateParams::Interval::OrSymbol,
+              threshold_amount: Integer,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The currency for the threshold amount. Currently, only `USD` is supported.
+            currency:,
+            # The time interval for evaluating spend against the threshold. Currently, only
+            # `month` is supported.
+            interval:,
+            # The hard spend limit amount, in cents.
+            threshold_amount:,
+            request_options: {}
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                currency:
+                  OpenAI::Admin::Organization::SpendLimitUpdateParams::Currency::OrSymbol,
+                interval:
+                  OpenAI::Admin::Organization::SpendLimitUpdateParams::Interval::OrSymbol,
+                threshold_amount: Integer,
+                request_options: OpenAI::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The currency for the threshold amount. Currently, only `USD` is supported.
+          module Currency
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Admin::Organization::SpendLimitUpdateParams::Currency
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            USD =
+              T.let(
+                :USD,
+                OpenAI::Admin::Organization::SpendLimitUpdateParams::Currency::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Admin::Organization::SpendLimitUpdateParams::Currency::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          # The time interval for evaluating spend against the threshold. Currently, only
+          # `month` is supported.
+          module Interval
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Admin::Organization::SpendLimitUpdateParams::Interval
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            MONTH =
+              T.let(
+                :month,
+                OpenAI::Admin::Organization::SpendLimitUpdateParams::Interval::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Admin::Organization::SpendLimitUpdateParams::Interval::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/beta/beta_response.rbi

@@ -204,10 +204,7 @@ module OpenAI
         # hit rates. Replaces the `user` field.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         sig { returns(T.nilable(String)) }
-        attr_reader :prompt_cache_key
-
-        sig { params(prompt_cache_key: String).void }
-        attr_writer :prompt_cache_key
+        attr_accessor :prompt_cache_key
 
         # The prompt-caching options that were applied to the response. Supported for
         # `gpt-5.6` and later models.
@@ -271,10 +268,7 @@ module OpenAI
         # identifying information.
         # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
-        attr_reader :safety_identifier
-
-        sig { params(safety_identifier: String).void }
-        attr_writer :safety_identifier
+        attr_accessor :safety_identifier
 
         # Specifies the processing type used for serving the request.
         #
@@ -452,7 +446,7 @@ module OpenAI
               T.nilable(OpenAI::Beta::BetaResponse::Moderation::OrHash),
             previous_response_id: T.nilable(String),
             prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt::OrHash),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Beta::BetaResponse::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -460,7 +454,7 @@ module OpenAI
                 OpenAI::Beta::BetaResponse::PromptCacheRetention::OrSymbol
               ),
             reasoning: T.nilable(OpenAI::Beta::BetaResponse::Reasoning::OrHash),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             service_tier:
               T.nilable(OpenAI::Beta::BetaResponse::ServiceTier::OrSymbol),
             status: OpenAI::Beta::BetaResponseStatus::OrSymbol,
@@ -691,7 +685,7 @@ module OpenAI
               moderation: T.nilable(OpenAI::Beta::BetaResponse::Moderation),
               previous_response_id: T.nilable(String),
               prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt),
-              prompt_cache_key: String,
+              prompt_cache_key: T.nilable(String),
               prompt_cache_options:
                 OpenAI::Beta::BetaResponse::PromptCacheOptions,
               prompt_cache_retention:
@@ -699,7 +693,7 @@ module OpenAI
                   OpenAI::Beta::BetaResponse::PromptCacheRetention::TaggedSymbol
                 ),
               reasoning: T.nilable(OpenAI::Beta::BetaResponse::Reasoning),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               service_tier:
                 T.nilable(
                   OpenAI::Beta::BetaResponse::ServiceTier::TaggedSymbol
@@ -2014,7 +2008,10 @@ module OpenAI
               )
             end
 
-          # Controls which reasoning items are rendered back to the model on later turns.
+          # Controls which reasoning items are rendered back to the model on later turns. If
+          # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+          # model family defaults to `all_turns`; earlier models default to `current_turn`.
+          #
           # When returned on a response, this is the effective reasoning context mode used
           # for the response.
           sig do
@@ -2121,7 +2118,10 @@ module OpenAI
             ).returns(T.attached_class)
           end
           def self.new(
-            # Controls which reasoning items are rendered back to the model on later turns.
+            # Controls which reasoning items are rendered back to the model on later turns. If
+            # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            # model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             # When returned on a response, this is the effective reasoning context mode used
             # for the response.
             context: nil,
@@ -2178,7 +2178,10 @@ module OpenAI
           def to_hash
           end
 
-          # Controls which reasoning items are rendered back to the model on later turns.
+          # Controls which reasoning items are rendered back to the model on later turns. If
+          # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+          # model family defaults to `all_turns`; earlier models default to `current_turn`.
+          #
           # When returned on a response, this is the effective reasoning context mode used
           # for the response.
           module Context

data/rbi/openai/models/beta/beta_response_error.rbi

@@ -70,6 +70,11 @@ module OpenAI
               :invalid_prompt,
               OpenAI::Beta::BetaResponseError::Code::TaggedSymbol
             )
+          DATA_RESIDENCY_MISMATCH =
+            T.let(
+              :data_residency_mismatch,
+              OpenAI::Beta::BetaResponseError::Code::TaggedSymbol
+            )
           BIO_POLICY =
             T.let(
               :bio_policy,

data/rbi/openai/models/beta/beta_response_text_config.rbi

@@ -54,7 +54,8 @@ module OpenAI
 
         # Constrains the verbosity of the model's response. Lower values will result in
         # more concise responses, while higher values will result in more verbose
-        # responses. Currently supported values are `low`, `medium`, and `high`.
+        # responses. Currently supported values are `low`, `medium`, and `high`. The
+        # default is `medium`.
         sig do
           returns(
             T.nilable(OpenAI::Beta::BetaResponseTextConfig::Verbosity::OrSymbol)
@@ -98,7 +99,8 @@ module OpenAI
           format_: nil,
           # Constrains the verbosity of the model's response. Lower values will result in
           # more concise responses, while higher values will result in more verbose
-          # responses. Currently supported values are `low`, `medium`, and `high`.
+          # responses. Currently supported values are `low`, `medium`, and `high`. The
+          # default is `medium`.
           verbosity: nil
         )
         end
@@ -124,7 +126,8 @@ module OpenAI
 
         # Constrains the verbosity of the model's response. Lower values will result in
         # more concise responses, while higher values will result in more verbose
-        # responses. Currently supported values are `low`, `medium`, and `high`.
+        # responses. Currently supported values are `low`, `medium`, and `high`. The
+        # default is `medium`.
         module Verbosity
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/beta/beta_responses_client_event.rbi

@@ -238,10 +238,7 @@ module OpenAI
           # hit rates. Replaces the `user` field.
           # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
           sig { returns(T.nilable(String)) }
-          attr_reader :prompt_cache_key
-
-          sig { params(prompt_cache_key: String).void }
-          attr_writer :prompt_cache_key
+          attr_accessor :prompt_cache_key
 
           # Options for prompt caching. Supported for `gpt-5.6` and later models. By
           # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
@@ -325,10 +322,7 @@ module OpenAI
           # identifying information.
           # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
           sig { returns(T.nilable(String)) }
-          attr_reader :safety_identifier
-
-          sig { params(safety_identifier: String).void }
-          attr_writer :safety_identifier
+          attr_accessor :safety_identifier
 
           # Specifies the processing type used for serving the request.
           #
@@ -612,7 +606,7 @@ module OpenAI
               parallel_tool_calls: T.nilable(T::Boolean),
               previous_response_id: T.nilable(String),
               prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt::OrHash),
-              prompt_cache_key: String,
+              prompt_cache_key: T.nilable(String),
               prompt_cache_options:
                 OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::OrHash,
               prompt_cache_retention:
@@ -623,7 +617,7 @@ module OpenAI
                 T.nilable(
                   OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::OrHash
                 ),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               service_tier:
                 T.nilable(
                   OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ServiceTier::OrSymbol
@@ -938,7 +932,7 @@ module OpenAI
                 parallel_tool_calls: T.nilable(T::Boolean),
                 previous_response_id: T.nilable(String),
                 prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt),
-                prompt_cache_key: String,
+                prompt_cache_key: T.nilable(String),
                 prompt_cache_options:
                   OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions,
                 prompt_cache_retention:
@@ -949,7 +943,7 @@ module OpenAI
                   T.nilable(
                     OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning
                   ),
-                safety_identifier: String,
+                safety_identifier: T.nilable(String),
                 service_tier:
                   T.nilable(
                     OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ServiceTier::OrSymbol
@@ -2198,7 +2192,10 @@ module OpenAI
                 )
               end
 
-            # Controls which reasoning items are rendered back to the model on later turns.
+            # Controls which reasoning items are rendered back to the model on later turns. If
+            # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            # model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             # When returned on a response, this is the effective reasoning context mode used
             # for the response.
             sig do
@@ -2310,7 +2307,10 @@ module OpenAI
               ).returns(T.attached_class)
             end
             def self.new(
-              # Controls which reasoning items are rendered back to the model on later turns.
+              # Controls which reasoning items are rendered back to the model on later turns. If
+              # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+              # model family defaults to `all_turns`; earlier models default to `current_turn`.
+              #
               # When returned on a response, this is the effective reasoning context mode used
               # for the response.
               context: nil,
@@ -2371,7 +2371,10 @@ module OpenAI
             def to_hash
             end
 
-            # Controls which reasoning items are rendered back to the model on later turns.
+            # Controls which reasoning items are rendered back to the model on later turns. If
+            # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            # model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             # When returned on a response, this is the effective reasoning context mode used
             # for the response.
             module Context

data/rbi/openai/models/beta/response_create_params.rbi

@@ -195,10 +195,7 @@ module OpenAI
         # hit rates. Replaces the `user` field.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         sig { returns(T.nilable(String)) }
-        attr_reader :prompt_cache_key
-
-        sig { params(prompt_cache_key: String).void }
-        attr_writer :prompt_cache_key
+        attr_accessor :prompt_cache_key
 
         # Options for prompt caching. Supported for `gpt-5.6` and later models. By
         # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
@@ -274,10 +271,7 @@ module OpenAI
         # identifying information.
         # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
-        attr_reader :safety_identifier
-
-        sig { params(safety_identifier: String).void }
-        attr_writer :safety_identifier
+        attr_accessor :safety_identifier
 
         # Specifies the processing type used for serving the request.
         #
@@ -546,7 +540,7 @@ module OpenAI
             parallel_tool_calls: T.nilable(T::Boolean),
             previous_response_id: T.nilable(String),
             prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt::OrHash),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -555,7 +549,7 @@ module OpenAI
               ),
             reasoning:
               T.nilable(OpenAI::Beta::ResponseCreateParams::Reasoning::OrHash),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             service_tier:
               T.nilable(
                 OpenAI::Beta::ResponseCreateParams::ServiceTier::OrSymbol
@@ -857,7 +851,7 @@ module OpenAI
               parallel_tool_calls: T.nilable(T::Boolean),
               previous_response_id: T.nilable(String),
               prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt),
-              prompt_cache_key: String,
+              prompt_cache_key: T.nilable(String),
               prompt_cache_options:
                 OpenAI::Beta::ResponseCreateParams::PromptCacheOptions,
               prompt_cache_retention:
@@ -866,7 +860,7 @@ module OpenAI
                 ),
               reasoning:
                 T.nilable(OpenAI::Beta::ResponseCreateParams::Reasoning),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               service_tier:
                 T.nilable(
                   OpenAI::Beta::ResponseCreateParams::ServiceTier::OrSymbol
@@ -2099,7 +2093,10 @@ module OpenAI
               )
             end
 
-          # Controls which reasoning items are rendered back to the model on later turns.
+          # Controls which reasoning items are rendered back to the model on later turns. If
+          # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+          # model family defaults to `all_turns`; earlier models default to `current_turn`.
+          #
           # When returned on a response, this is the effective reasoning context mode used
           # for the response.
           sig do
@@ -2211,7 +2208,10 @@ module OpenAI
             ).returns(T.attached_class)
           end
           def self.new(
-            # Controls which reasoning items are rendered back to the model on later turns.
+            # Controls which reasoning items are rendered back to the model on later turns. If
+            # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            # model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             # When returned on a response, this is the effective reasoning context mode used
             # for the response.
             context: nil,
@@ -2272,7 +2272,10 @@ module OpenAI
           def to_hash
           end
 
-          # Controls which reasoning items are rendered back to the model on later turns.
+          # Controls which reasoning items are rendered back to the model on later turns. If
+          # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+          # model family defaults to `all_turns`; earlier models default to `current_turn`.
+          #
           # When returned on a response, this is the effective reasoning context mode used
           # for the response.
           module Context

data/rbi/openai/models/beta/responses/input_token_count_params.rbi

@@ -544,7 +544,10 @@ module OpenAI
                 )
               end
 
-            # Controls which reasoning items are rendered back to the model on later turns.
+            # Controls which reasoning items are rendered back to the model on later turns. If
+            # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            # model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             # When returned on a response, this is the effective reasoning context mode used
             # for the response.
             sig do
@@ -654,7 +657,10 @@ module OpenAI
               ).returns(T.attached_class)
             end
             def self.new(
-              # Controls which reasoning items are rendered back to the model on later turns.
+              # Controls which reasoning items are rendered back to the model on later turns. If
+              # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+              # model family defaults to `all_turns`; earlier models default to `current_turn`.
+              #
               # When returned on a response, this is the effective reasoning context mode used
               # for the response.
               context: nil,
@@ -715,7 +721,10 @@ module OpenAI
             def to_hash
             end
 
-            # Controls which reasoning items are rendered back to the model on later turns.
+            # Controls which reasoning items are rendered back to the model on later turns. If
+            # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            # model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             # When returned on a response, this is the effective reasoning context mode used
             # for the response.
             module Context
@@ -1006,7 +1015,8 @@ module OpenAI
 
             # Constrains the verbosity of the model's response. Lower values will result in
             # more concise responses, while higher values will result in more verbose
-            # responses. Currently supported values are `low`, `medium`, and `high`.
+            # responses. Currently supported values are `low`, `medium`, and `high`. The
+            # default is `medium`.
             sig do
               returns(
                 T.nilable(
@@ -1052,7 +1062,8 @@ module OpenAI
               format_: nil,
               # Constrains the verbosity of the model's response. Lower values will result in
               # more concise responses, while higher values will result in more verbose
-              # responses. Currently supported values are `low`, `medium`, and `high`.
+              # responses. Currently supported values are `low`, `medium`, and `high`. The
+              # default is `medium`.
               verbosity: nil
             )
             end
@@ -1078,7 +1089,8 @@ module OpenAI
 
             # Constrains the verbosity of the model's response. Lower values will result in
             # more concise responses, while higher values will result in more verbose
-            # responses. Currently supported values are `low`, `medium`, and `high`.
+            # responses. Currently supported values are `low`, `medium`, and `high`. The
+            # default is `medium`.
             module Verbosity
               extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/chat/completion_create_params.rbi

@@ -236,10 +236,7 @@ module OpenAI
         # hit rates. Replaces the `user` field.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         sig { returns(T.nilable(String)) }
-        attr_reader :prompt_cache_key
-
-        sig { params(prompt_cache_key: String).void }
-        attr_writer :prompt_cache_key
+        attr_accessor :prompt_cache_key
 
         # Options for prompt caching. Supported for `gpt-5.6` and later models. By
         # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
@@ -344,10 +341,7 @@ module OpenAI
         # identifying information.
         # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
-        attr_reader :safety_identifier
-
-        sig { params(safety_identifier: String).void }
-        attr_writer :safety_identifier
+        attr_accessor :safety_identifier
 
         # This feature is in Beta. If specified, our system will make a best effort to
         # sample deterministically, such that repeated requests with the same `seed` and
@@ -515,7 +509,8 @@ module OpenAI
 
         # Constrains the verbosity of the model's response. Lower values will result in
         # more concise responses, while higher values will result in more verbose
-        # responses. Currently supported values are `low`, `medium`, and `high`.
+        # responses. Currently supported values are `low`, `medium`, and `high`. The
+        # default is `medium`.
         sig do
           returns(
             T.nilable(OpenAI::Chat::CompletionCreateParams::Verbosity::OrSymbol)
@@ -584,7 +579,7 @@ module OpenAI
             prediction:
               T.nilable(OpenAI::Chat::ChatCompletionPredictionContent::OrHash),
             presence_penalty: T.nilable(Float),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Chat::CompletionCreateParams::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -599,7 +594,7 @@ module OpenAI
                 OpenAI::StructuredOutput::JsonSchemaConverter,
                 OpenAI::ResponseFormatJSONObject::OrHash
               ),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             seed: T.nilable(Integer),
             service_tier:
               T.nilable(
@@ -870,7 +865,8 @@ module OpenAI
           user: nil,
           # Constrains the verbosity of the model's response. Lower values will result in
           # more concise responses, while higher values will result in more verbose
-          # responses. Currently supported values are `low`, `medium`, and `high`.
+          # responses. Currently supported values are `low`, `medium`, and `high`. The
+          # default is `medium`.
           verbosity: nil,
           # This tool searches the web for relevant results to use in a response. Learn more
           # about the
@@ -922,7 +918,7 @@ module OpenAI
               prediction:
                 T.nilable(OpenAI::Chat::ChatCompletionPredictionContent),
               presence_penalty: T.nilable(Float),
-              prompt_cache_key: String,
+              prompt_cache_key: T.nilable(String),
               prompt_cache_options:
                 OpenAI::Chat::CompletionCreateParams::PromptCacheOptions,
               prompt_cache_retention:
@@ -936,7 +932,7 @@ module OpenAI
                   OpenAI::ResponseFormatJSONSchema,
                   OpenAI::ResponseFormatJSONObject
                 ),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               seed: T.nilable(Integer),
               service_tier:
                 T.nilable(
@@ -1819,7 +1815,8 @@ module OpenAI
 
         # Constrains the verbosity of the model's response. Lower values will result in
         # more concise responses, while higher values will result in more verbose
-        # responses. Currently supported values are `low`, `medium`, and `high`.
+        # responses. Currently supported values are `low`, `medium`, and `high`. The
+        # default is `medium`.
         module Verbosity
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/reasoning.rbi

@@ -6,7 +6,10 @@ module OpenAI
       OrHash =
         T.type_alias { T.any(OpenAI::Reasoning, OpenAI::Internal::AnyHash) }
 
-      # Controls which reasoning items are rendered back to the model on later turns.
+      # Controls which reasoning items are rendered back to the model on later turns. If
+      # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+      # model family defaults to `all_turns`; earlier models default to `current_turn`.
+      #
       # When returned on a response, this is the effective reasoning context mode used
       # for the response.
       sig { returns(T.nilable(OpenAI::Reasoning::Context::OrSymbol)) }
@@ -66,7 +69,10 @@ module OpenAI
         ).returns(T.attached_class)
       end
       def self.new(
-        # Controls which reasoning items are rendered back to the model on later turns.
+        # Controls which reasoning items are rendered back to the model on later turns. If
+        # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+        # model family defaults to `all_turns`; earlier models default to `current_turn`.
+        #
         # When returned on a response, this is the effective reasoning context mode used
         # for the response.
         context: nil,
@@ -112,7 +118,10 @@ module OpenAI
       def to_hash
       end
 
-      # Controls which reasoning items are rendered back to the model on later turns.
+      # Controls which reasoning items are rendered back to the model on later turns. If
+      # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+      # model family defaults to `all_turns`; earlier models default to `current_turn`.
+      #
       # When returned on a response, this is the effective reasoning context mode used
       # for the response.
       module Context