fix(api): docs updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 135
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-a4bb37d110a22c2888f53e21281434686a6fffa3e672a40f2503ad9bd2759063.yml
-openapi_spec_hash: 2d59eefb494dff4eea8c3d008c7e2070
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-a3c45d9bd3bb25bf4eaa49b7fb473a00038293dec659ffaa44f624ded884abf4.yml
+openapi_spec_hash: 9c20aaf786a0700dabd13d9865481c9e
 config_hash: 50ee3382a63c021a9f821a935950e926

lib/openai/models/realtime/realtime_session_create_response.rb

@@ -990,7 +990,7 @@ module McpToolApprovalSetting
         module Tracing
           extend OpenAI::Internal::Type::Union
 
-          # Default tracing mode for the session.
+          # Enables tracing and sets default values for tracing configuration options. Always `auto`.
           variant const: :auto
 
           # Granular configuration for tracing.

lib/openai/models/realtime/realtime_tracing_config.rb

@@ -12,7 +12,7 @@ module Realtime
       module RealtimeTracingConfig
         extend OpenAI::Internal::Type::Union
 
-        # Default tracing mode for the session.
+        # Enables tracing and sets default values for tracing configuration options. Always `auto`.
         variant const: :auto
 
         # Granular configuration for tracing.

lib/openai/models/reasoning.rb

@@ -33,6 +33,8 @@ class Reasoning < OpenAI::Internal::Type::BaseModel
       #   debugging and understanding the model's reasoning process. One of `auto`,
       #   `concise`, or `detailed`.
       #
+      #   `concise` is only supported for `computer-use-preview` models.
+      #
       #   @return [Symbol, OpenAI::Models::Reasoning::Summary, nil]
       optional :summary, enum: -> { OpenAI::Reasoning::Summary }, nil?: true
 
@@ -75,6 +77,8 @@ module GenerateSummary
       # debugging and understanding the model's reasoning process. One of `auto`,
       # `concise`, or `detailed`.
       #
+      # `concise` is only supported for `computer-use-preview` models.
+      #
       # @see OpenAI::Models::Reasoning#summary
       module Summary
         extend OpenAI::Internal::Type::Enum

lib/openai/resources/files.rb

@@ -10,20 +10,19 @@ class Files
       # up to 512 MB, and the size of all files uploaded by one organization can be up
       # to 1 TB.
       #
-      # The Assistants API supports files up to 2 million tokens and of specific file
-      # types. See the
-      # [Assistants Tools guide](https://platform.openai.com/docs/assistants/tools) for
-      # details.
-      #
-      # The Fine-tuning API only supports `.jsonl` files. The input also has certain
-      # required formats for fine-tuning
-      # [chat](https://platform.openai.com/docs/api-reference/fine-tuning/chat-input) or
-      # [completions](https://platform.openai.com/docs/api-reference/fine-tuning/completions-input)
-      # models.
-      #
-      # The Batch API only supports `.jsonl` files up to 200 MB in size. The input also
-      # has a specific required
-      # [format](https://platform.openai.com/docs/api-reference/batch/request-input).
+      # - The Assistants API supports files up to 2 million tokens and of specific file
+      #   types. See the
+      #   [Assistants Tools guide](https://platform.openai.com/docs/assistants/tools)
+      #   for details.
+      # - The Fine-tuning API only supports `.jsonl` files. The input also has certain
+      #   required formats for fine-tuning
+      #   [chat](https://platform.openai.com/docs/api-reference/fine-tuning/chat-input)
+      #   or
+      #   [completions](https://platform.openai.com/docs/api-reference/fine-tuning/completions-input)
+      #   models.
+      # - The Batch API only supports `.jsonl` files up to 200 MB in size. The input
+      #   also has a specific required
+      #   [format](https://platform.openai.com/docs/api-reference/batch/request-input).
       #
       # Please [contact us](https://help.openai.com/) if you need to increase these
       # storage limits.

rbi/openai/models/reasoning.rbi

@@ -28,6 +28,8 @@ module OpenAI
       # A summary of the reasoning performed by the model. This can be useful for
       # debugging and understanding the model's reasoning process. One of `auto`,
       # `concise`, or `detailed`.
+      #
+      # `concise` is only supported for `computer-use-preview` models.
       sig { returns(T.nilable(OpenAI::Reasoning::Summary::OrSymbol)) }
       attr_accessor :summary
 
@@ -62,6 +64,8 @@ module OpenAI
         # A summary of the reasoning performed by the model. This can be useful for
         # debugging and understanding the model's reasoning process. One of `auto`,
         # `concise`, or `detailed`.
+        #
+        # `concise` is only supported for `computer-use-preview` models.
         summary: nil
       )
       end
@@ -109,6 +113,8 @@ module OpenAI
       # A summary of the reasoning performed by the model. This can be useful for
       # debugging and understanding the model's reasoning process. One of `auto`,
       # `concise`, or `detailed`.
+      #
+      # `concise` is only supported for `computer-use-preview` models.
       module Summary
         extend OpenAI::Internal::Type::Enum
 

rbi/openai/resources/files.rbi

@@ -7,20 +7,19 @@ module OpenAI
       # up to 512 MB, and the size of all files uploaded by one organization can be up
       # to 1 TB.
       #
-      # The Assistants API supports files up to 2 million tokens and of specific file
-      # types. See the
-      # [Assistants Tools guide](https://platform.openai.com/docs/assistants/tools) for
-      # details.
-      #
-      # The Fine-tuning API only supports `.jsonl` files. The input also has certain
-      # required formats for fine-tuning
-      # [chat](https://platform.openai.com/docs/api-reference/fine-tuning/chat-input) or
-      # [completions](https://platform.openai.com/docs/api-reference/fine-tuning/completions-input)
-      # models.
-      #
-      # The Batch API only supports `.jsonl` files up to 200 MB in size. The input also
-      # has a specific required
-      # [format](https://platform.openai.com/docs/api-reference/batch/request-input).
+      # - The Assistants API supports files up to 2 million tokens and of specific file
+      #   types. See the
+      #   [Assistants Tools guide](https://platform.openai.com/docs/assistants/tools)
+      #   for details.
+      # - The Fine-tuning API only supports `.jsonl` files. The input also has certain
+      #   required formats for fine-tuning
+      #   [chat](https://platform.openai.com/docs/api-reference/fine-tuning/chat-input)
+      #   or
+      #   [completions](https://platform.openai.com/docs/api-reference/fine-tuning/completions-input)
+      #   models.
+      # - The Batch API only supports `.jsonl` files up to 200 MB in size. The input
+      #   also has a specific required
+      #   [format](https://platform.openai.com/docs/api-reference/batch/request-input).
       #
       # Please [contact us](https://help.openai.com/) if you need to increase these
       # storage limits.