openai 0.71.0 → 0.72.0

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

@@ -204,7 +204,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   The prompt-caching options that were applied to the response. Supported for
@@ -257,7 +257,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -382,7 +382,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Beta::BetaResponse::PromptCacheOptions] The prompt-caching options that were applied to the response. Supported for `gpt
         #
@@ -390,7 +390,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Beta::BetaResponse::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Beta::BetaResponse::ServiceTier, nil] Specifies the processing type used for serving the request.
         #
@@ -1190,7 +1190,10 @@ module OpenAI
         # @see OpenAI::Models::Beta::BetaResponse#reasoning
         class Reasoning < OpenAI::Internal::Type::BaseModel
           # @!attribute context
-          #   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.
           #
@@ -1260,7 +1263,10 @@ module OpenAI
           #
           #   @param summary [Symbol, OpenAI::Models::Beta::BetaResponse::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-          # 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.
           #

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

@@ -35,6 +35,7 @@ module OpenAI
           SERVER_ERROR = :server_error
           RATE_LIMIT_EXCEEDED = :rate_limit_exceeded
           INVALID_PROMPT = :invalid_prompt
+          DATA_RESIDENCY_MISMATCH = :data_residency_mismatch
           BIO_POLICY = :bio_policy
           VECTOR_STORE_TIMEOUT = :vector_store_timeout
           INVALID_IMAGE = :invalid_image

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

@@ -25,7 +25,8 @@ module OpenAI
         # @!attribute verbosity
         #   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`.
         #
         #   @return [Symbol, OpenAI::Models::Beta::BetaResponseTextConfig::Verbosity, nil]
         optional :verbosity, enum: -> { OpenAI::Beta::BetaResponseTextConfig::Verbosity }, nil?: true
@@ -46,7 +47,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`.
         #
         # @see OpenAI::Models::Beta::BetaResponseTextConfig#verbosity
         module Verbosity

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

@@ -188,7 +188,7 @@ module OpenAI
           #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
           #
           #   @return [String, nil]
-          optional :prompt_cache_key, String
+          optional :prompt_cache_key, String, nil?: true
 
           # @!attribute prompt_cache_options
           #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -253,7 +253,7 @@ module OpenAI
           #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
           #
           #   @return [String, nil]
-          optional :safety_identifier, String
+          optional :safety_identifier, String, nil?: true
 
           # @!attribute service_tier
           #   Specifies the processing type used for serving the request.
@@ -443,7 +443,7 @@ module OpenAI
           #
           #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Reference to a prompt template and its variables.
           #
-          #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+          #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
           #
           #   @param prompt_cache_options [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
           #
@@ -451,7 +451,7 @@ module OpenAI
           #
           #   @param reasoning [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning, nil] **gpt-5 and o-series models only**
           #
-          #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+          #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
           #
           #   @param service_tier [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::ServiceTier, nil] Specifies the processing type used for serving the request.
           #
@@ -1102,7 +1102,10 @@ module OpenAI
           # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate#reasoning
           class Reasoning < OpenAI::Internal::Type::BaseModel
             # @!attribute context
-            #   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.
             #
@@ -1181,7 +1184,10 @@ module OpenAI
             #
             #   @param summary [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-            # 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.
             #

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

@@ -163,7 +163,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -223,7 +223,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -392,7 +392,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -400,7 +400,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Beta::ResponseCreateParams::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Beta::ResponseCreateParams::ServiceTier, nil] Specifies the processing type used for serving the request.
         #
@@ -1027,7 +1027,10 @@ module OpenAI
 
         class Reasoning < OpenAI::Internal::Type::BaseModel
           # @!attribute context
-          #   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.
           #
@@ -1097,7 +1100,10 @@ module OpenAI
           #
           #   @param summary [Symbol, OpenAI::Models::Beta::ResponseCreateParams::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-          # 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.
           #

data/lib/openai/models/beta/responses/input_token_count_params.rb

@@ -214,7 +214,10 @@ module OpenAI
 
           class Reasoning < OpenAI::Internal::Type::BaseModel
             # @!attribute context
-            #   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.
             #
@@ -289,7 +292,10 @@ module OpenAI
             #
             #   @param summary [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-            # 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.
             #
@@ -419,7 +425,8 @@ module OpenAI
             # @!attribute verbosity
             #   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`.
             #
             #   @return [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Text::Verbosity, nil]
             optional :verbosity,
@@ -442,7 +449,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`.
             #
             # @see OpenAI::Models::Beta::Responses::InputTokenCountParams::Text#verbosity
             module Verbosity

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

@@ -194,7 +194,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -271,7 +271,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute seed
         #   @deprecated
@@ -401,7 +401,8 @@ module OpenAI
         # @!attribute verbosity
         #   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`.
         #
         #   @return [Symbol, OpenAI::Models::Chat::CompletionCreateParams::Verbosity, nil]
         optional :verbosity, enum: -> { OpenAI::Chat::CompletionCreateParams::Verbosity }, nil?: true
@@ -452,7 +453,7 @@ module OpenAI
         #
         #   @param presence_penalty [Float, nil] Number between -2.0 and 2.0. Positive values penalize new tokens based on
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Chat::CompletionCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -462,7 +463,7 @@ module OpenAI
         #
         #   @param response_format [OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONSchema, OpenAI::StructuredOutput::JsonSchemaConverter, OpenAI::Models::ResponseFormatJSONObject] An object specifying the format that the model must output.
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param seed [Integer, nil] This feature is in Beta.
         #
@@ -894,7 +895,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/lib/openai/models/reasoning.rb

@@ -4,7 +4,10 @@ module OpenAI
   module Models
     class Reasoning < OpenAI::Internal::Type::BaseModel
       # @!attribute context
-      #   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.
       #
@@ -72,7 +75,10 @@ module OpenAI
       #
       #   @param summary [Symbol, OpenAI::Models::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-      # 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.
       #

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

@@ -225,7 +225,8 @@ module OpenAI
           # @!attribute verbosity
           #   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`.
           #
           #   @return [Symbol, OpenAI::Models::Responses::InputTokenCountParams::Text::Verbosity, nil]
           optional :verbosity,
@@ -250,7 +251,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`.
           #
           # @see OpenAI::Models::Responses::InputTokenCountParams::Text#verbosity
           module Verbosity

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

@@ -204,7 +204,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   The prompt-caching options that were applied to the response. Supported for
@@ -257,7 +257,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -402,7 +402,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Responses::Response::PromptCacheOptions] The prompt-caching options that were applied to the response. Supported for `gpt
         #
@@ -410,7 +410,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Responses::Response::ServiceTier, nil] Specifies the processing type used for serving the request.
         #

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

@@ -161,7 +161,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -221,7 +221,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -389,7 +389,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -397,7 +397,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Responses::ResponseCreateParams::ServiceTier, nil] Specifies the processing type used for serving the request.
         #

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

@@ -35,6 +35,7 @@ module OpenAI
           SERVER_ERROR = :server_error
           RATE_LIMIT_EXCEEDED = :rate_limit_exceeded
           INVALID_PROMPT = :invalid_prompt
+          DATA_RESIDENCY_MISMATCH = :data_residency_mismatch
           BIO_POLICY = :bio_policy
           VECTOR_STORE_TIMEOUT = :vector_store_timeout
           INVALID_IMAGE = :invalid_image

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

@@ -25,7 +25,8 @@ module OpenAI
         # @!attribute verbosity
         #   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`.
         #
         #   @return [Symbol, OpenAI::Models::Responses::ResponseTextConfig::Verbosity, nil]
         optional :verbosity, enum: -> { OpenAI::Responses::ResponseTextConfig::Verbosity }, nil?: true
@@ -46,7 +47,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`.
         #
         # @see OpenAI::Models::Responses::ResponseTextConfig#verbosity
         module Verbosity

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

@@ -161,7 +161,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -221,7 +221,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -394,7 +394,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Responses::ResponsesClientEvent::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -402,7 +402,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Responses::ResponsesClientEvent::ServiceTier, nil] Specifies the processing type used for serving the request.
         #

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

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class Projects
+          class SpendLimit
+            # Get a project's hard spend limit.
+            #
+            # @overload retrieve(project_id, request_options: {})
+            #
+            # @param project_id [String] The ID of the project whose hard spend limit is being managed.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Models::Admin::Organization::Projects::ProjectSpendLimit]
+            #
+            # @see OpenAI::Models::Admin::Organization::Projects::SpendLimitRetrieveParams
+            def retrieve(project_id, params = {})
+              @client.request(
+                method: :get,
+                path: ["organization/projects/%1$s/spend_limit", project_id],
+                model: OpenAI::Admin::Organization::Projects::ProjectSpendLimit,
+                security: {admin_api_key_auth: true},
+                options: params[:request_options]
+              )
+            end
+
+            # Some parameter documentations has been truncated, see
+            # {OpenAI::Models::Admin::Organization::Projects::SpendLimitUpdateParams} for more
+            # details.
+            #
+            # Create or replace a project's hard spend limit.
+            #
+            # @overload update(project_id, currency:, interval:, threshold_amount:, request_options: {})
+            #
+            # @param project_id [String] The ID of the project whose hard spend limit is being managed.
+            #
+            # @param currency [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendLimitUpdateParams::Currency] The currency for the threshold amount. Currently, only `USD` is supported.
+            #
+            # @param interval [Symbol, OpenAI::Models::Admin::Organization::Projects::SpendLimitUpdateParams::Interval] The time interval for evaluating spend against the threshold. Currently, only `m
+            #
+            # @param threshold_amount [Integer] The hard spend limit amount, in cents.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Models::Admin::Organization::Projects::ProjectSpendLimit]
+            #
+            # @see OpenAI::Models::Admin::Organization::Projects::SpendLimitUpdateParams
+            def update(project_id, params)
+              parsed, options = OpenAI::Admin::Organization::Projects::SpendLimitUpdateParams.dump_request(params)
+              @client.request(
+                method: :post,
+                path: ["organization/projects/%1$s/spend_limit", project_id],
+                body: parsed,
+                model: OpenAI::Admin::Organization::Projects::ProjectSpendLimit,
+                security: {admin_api_key_auth: true},
+                options: options
+              )
+            end
+
+            # Delete a project's hard spend limit.
+            #
+            # @overload delete(project_id, request_options: {})
+            #
+            # @param project_id [String] The ID of the project whose hard spend limit is being managed.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Models::Admin::Organization::Projects::ProjectSpendLimitDeleted]
+            #
+            # @see OpenAI::Models::Admin::Organization::Projects::SpendLimitDeleteParams
+            def delete(project_id, params = {})
+              @client.request(
+                method: :delete,
+                path: ["organization/projects/%1$s/spend_limit", project_id],
+                model: OpenAI::Admin::Organization::Projects::ProjectSpendLimitDeleted,
+                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
+end

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

@@ -32,6 +32,9 @@ module OpenAI
           # @return [OpenAI::Resources::Admin::Organization::Projects::DataRetention]
           attr_reader :data_retention
 
+          # @return [OpenAI::Resources::Admin::Organization::Projects::SpendLimit]
+          attr_reader :spend_limit
+
           # @return [OpenAI::Resources::Admin::Organization::Projects::SpendAlerts]
           attr_reader :spend_alerts
 
@@ -189,6 +192,7 @@ module OpenAI
             @groups = OpenAI::Resources::Admin::Organization::Projects::Groups.new(client: client)
             @roles = OpenAI::Resources::Admin::Organization::Projects::Roles.new(client: client)
             @data_retention = OpenAI::Resources::Admin::Organization::Projects::DataRetention.new(client: client)
+            @spend_limit = OpenAI::Resources::Admin::Organization::Projects::SpendLimit.new(client: client)
             @spend_alerts = OpenAI::Resources::Admin::Organization::Projects::SpendAlerts.new(client: client)
             @certificates = OpenAI::Resources::Admin::Organization::Projects::Certificates.new(client: client)
           end