openai 0.91.0 → 0.93.0

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

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class ExternalStorage
+          # Register one customer-managed external storage configuration.
+          #
+          # @overload create(project_id:, provider:, request_options: {})
+          #
+          # @param project_id [String]
+          # @param provider [OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Aws, OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Azure]
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::ExternalStorageConfiguration]
+          #
+          # @see OpenAI::Models::Admin::Organization::ExternalStorageCreateParams
+          def create(params)
+            parsed, options = OpenAI::Admin::Organization::ExternalStorageCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "organization/external_storage",
+              body: parsed,
+              model: OpenAI::Admin::Organization::ExternalStorageConfiguration,
+              security: {admin_api_key_auth: true},
+              options: options
+            )
+          end
+
+          # Get one customer-managed external storage configuration.
+          #
+          # @overload retrieve(external_storage_id, request_options: {})
+          #
+          # @param external_storage_id [String]
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::ExternalStorageConfiguration]
+          #
+          # @see OpenAI::Models::Admin::Organization::ExternalStorageRetrieveParams
+          def retrieve(external_storage_id, params = {})
+            @client.request(
+              method: :get,
+              path: ["organization/external_storage/%1$s", external_storage_id],
+              model: OpenAI::Admin::Organization::ExternalStorageConfiguration,
+              security: {admin_api_key_auth: true},
+              options: params[:request_options]
+            )
+          end
+
+          # List the organization's customer-managed external storage configurations.
+          #
+          # @overload list(after: nil, limit: nil, order: nil, project_id: nil, request_options: {})
+          #
+          # @param after [String, nil]
+          #   Return external storage configurations after this ID.
+          #
+          # @param limit [Integer]
+          #
+          # @param order [Symbol, OpenAI::Models::Admin::Organization::ExternalStorageListParams::Order]
+          #
+          # @param project_id [String, nil]
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Admin::Organization::ExternalStorageConfiguration>]
+          #
+          # @see OpenAI::Models::Admin::Organization::ExternalStorageListParams
+          def list(params = {})
+            parsed, options = OpenAI::Admin::Organization::ExternalStorageListParams.dump_request(params)
+            query = OpenAI::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "organization/external_storage",
+              query: query,
+              page: OpenAI::Internal::CursorPage,
+              model: OpenAI::Admin::Organization::ExternalStorageConfiguration,
+              security: {admin_api_key_auth: true},
+              options: options
+            )
+          end
+
+          # Disconnect a customer-managed external storage configuration. Removing the
+          # project's last configuration restores organization-default retention if
+          # customer-managed retention was active. Repeating a deletion also completes any
+          # interrupted retention update. Cloud storage is unchanged.
+          #
+          # @overload delete(external_storage_id, request_options: {})
+          #
+          # @param external_storage_id [String]
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::ExternalStorageDeleted]
+          #
+          # @see OpenAI::Models::Admin::Organization::ExternalStorageDeleteParams
+          def delete(external_storage_id, params = {})
+            @client.request(
+              method: :delete,
+              path: ["organization/external_storage/%1$s", external_storage_id],
+              model: OpenAI::Admin::Organization::ExternalStorageDeleted,
+              security: {admin_api_key_auth: true},
+              options: params[:request_options]
+            )
+          end
+
+          # Validate one customer-managed external storage configuration.
+          #
+          # @overload validate(external_storage_id, request_options: {})
+          #
+          # @param external_storage_id [String]
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::ExternalStorageConfiguration]
+          #
+          # @see OpenAI::Models::Admin::Organization::ExternalStorageValidateParams
+          def validate(external_storage_id, params = {})
+            @client.request(
+              method: :post,
+              path: ["organization/external_storage/%1$s/validate", external_storage_id],
+              model: OpenAI::Admin::Organization::ExternalStorageConfiguration,
+              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

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

@@ -29,6 +29,9 @@ module OpenAI
         # @return [OpenAI::Resources::Admin::Organization::DataRetention]
         attr_reader :data_retention
 
+        # @return [OpenAI::Resources::Admin::Organization::ExternalStorage]
+        attr_reader :external_storage
+
         # @return [OpenAI::Resources::Admin::Organization::SpendLimit]
         attr_reader :spend_limit
 
@@ -54,6 +57,7 @@ module OpenAI
           @groups = OpenAI::Resources::Admin::Organization::Groups.new(client: client)
           @roles = OpenAI::Resources::Admin::Organization::Roles.new(client: client)
           @data_retention = OpenAI::Resources::Admin::Organization::DataRetention.new(client: client)
+          @external_storage = OpenAI::Resources::Admin::Organization::ExternalStorage.new(client: client)
           @spend_limit = OpenAI::Resources::Admin::Organization::SpendLimit.new(client: client)
           @spend_alerts = OpenAI::Resources::Admin::Organization::SpendAlerts.new(client: client)
           @certificates = OpenAI::Resources::Admin::Organization::Certificates.new(client: client)

data/lib/openai/resources/beta/agents/environments/templates.rb

@@ -26,10 +26,11 @@ module OpenAI
             #   An optional human-readable display name for the template.
             #
             # @param network [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Network, nil]
-            #   Network access for an OpenAI-hosted environment.
+            #   Network access policy for the environment. Defaults to disabled for GA requests
+            #   and enabled for alpha/beta requests.
             #
             # @param packages [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Packages, nil]
-            #   Packages to install in an OpenAI-hosted environment.
+            #   Packages to install in the environment. Defaults to empty package lists.
             #
             # @param plugins [Array<OpenAI::Models::Beta::HostedPluginParam>, nil]
             #   Plugins provided as inline ZIP archives. Defaults to an empty list.
@@ -104,10 +105,12 @@ module OpenAI
             #   A replacement human-readable display name, or `null` to clear the name.
             #
             # @param network [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Network, nil]
-            #   Network access for an OpenAI-hosted environment.
+            #   Network access available after setup completes. Omit to preserve the current
+            #   policy, or pass `null` to reset to disabled for GA requests or enabled for
+            #   alpha/beta requests.
             #
             # @param packages [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Packages, nil]
-            #   Packages to install in an OpenAI-hosted environment.
+            #   Packages installed before the runtime network policy applies.
             #
             # @param plugins [Array<OpenAI::Models::Beta::HostedPluginParam>, nil]
             #   Replacement plugin configuration installed for each new session.

data/lib/openai/resources/beta/agents/sessions/events.rb

@@ -7,7 +7,10 @@ module OpenAI
         class Sessions
           class Events
             # Submits message, cancellation, or tool-result events to a managed agent session.
-            # See
+            # Cancellation can recover a still-open turn whose backend execution has ended by
+            # marking it cancelled and abandoning unpublished outputs. Saved results,
+            # published files, and existing terminal outcomes are preserved. HTTP 202 confirms
+            # acceptance, not durable completion. See
             # [session events](https://developers.openai.com/api/docs/guides/agents-api/sessions/events).
             #
             # @overload create(session_id, events:, idempotency_key: nil, request_options: {})
@@ -51,7 +54,7 @@ module OpenAI
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
-            # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent>]
+            # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentSessionEnvironmentResetEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent>]
             #
             # @see OpenAI::Models::Beta::Agents::Sessions::EventStreamParams
             def stream_streaming(session_id, params = {})

data/lib/openai/resources/beta/agents/sessions.rb

@@ -41,7 +41,10 @@ module OpenAI
           #   unchanged.
           #
           # @param input [String, Array<OpenAI::Models::Beta::AgentSessionInputMessageParam>, nil]
-          #   Initial input submitted when creating a session.
+          #   Initial input to submit when the session is created. A string is shorthand for a
+          #   single user message. Required when `environment.type` is `none`, or when
+          #   `stream` is `true` for an environment that is not `self_hosted`; optional for
+          #   self-hosted and non-streaming execution environments.
           #
           # @param metadata [Hash{Symbol=>String}, nil]
           #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
@@ -93,7 +96,10 @@ module OpenAI
           #   unchanged.
           #
           # @param input [String, Array<OpenAI::Models::Beta::AgentSessionInputMessageParam>, nil]
-          #   Initial input submitted when creating a session.
+          #   Initial input to submit when the session is created. A string is shorthand for a
+          #   single user message. Required when `environment.type` is `none`, or when
+          #   `stream` is `true` for an environment that is not `self_hosted`; optional for
+          #   self-hosted and non-streaming execution environments.
           #
           # @param metadata [Hash{Symbol=>String}, nil]
           #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
@@ -104,7 +110,7 @@ module OpenAI
           #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent>]
+          # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentSessionEnvironmentResetEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent>]
           #
           # @see OpenAI::Models::Beta::Agents::SessionCreateParams
           def create_streaming(params)
@@ -224,7 +230,9 @@ module OpenAI
           end
 
           # Removes a managed agent session from the public API and returns a deletion
-          # confirmation. Physical cleanup may continue asynchronously. See
+          # confirmation. If backend execution has ended, deletion can cancel a still-open
+          # public turn and abandon unpublished outputs. Running execution must be cancelled
+          # first. Physical cleanup may continue asynchronously. See
           # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
           #
           # @overload delete(session_id, request_options: {})

data/lib/openai/resources/beta/agents/vaults/credentials.rb

@@ -15,8 +15,8 @@ module OpenAI
             # @param vault_id [String]
             #   The ID of the vault.
             #
-            # @param auth [OpenAI::Models::Beta::Agents::Vaults::CredentialAuthCreateParam::McpOauth, OpenAI::Models::Beta::Agents::Vaults::CredentialAuthCreateParam::StaticBearer]
-            #   The authentication method and secret values to store for the MCP server.
+            # @param auth [OpenAI::Models::Beta::Agents::Vaults::CredentialAuthCreateParam::McpOauth, OpenAI::Models::Beta::Agents::Vaults::CredentialAuthCreateParam::StaticBearer, OpenAI::Models::Beta::Agents::Vaults::CredentialAuthCreateParam::EnvironmentVariable]
+            #   The authentication method and write-only secret values to store.
             #
             # @param name [String]
             #   The name is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after
@@ -82,7 +82,7 @@ module OpenAI
             # @param vault_id [String]
             #   Path param: The ID of the vault.
             #
-            # @param auth [OpenAI::Models::Beta::Agents::Vaults::CredentialAuthRotateParam::McpOauth, OpenAI::Models::Beta::Agents::Vaults::CredentialAuthRotateParam::StaticBearer]
+            # @param auth [OpenAI::Models::Beta::Agents::Vaults::CredentialAuthRotateParam::McpOauth, OpenAI::Models::Beta::Agents::Vaults::CredentialAuthRotateParam::StaticBearer, OpenAI::Models::Beta::Agents::Vaults::CredentialAuthRotateParam::EnvironmentVariable]
             #   Body param: Replacement values for the credential's existing authentication
             #   method.
             #

data/lib/openai/resources/beta/agents.rb

@@ -30,19 +30,21 @@ module OpenAI
         #   characters. Omission or null defaults to an empty map.
         #
         # @param multi_agent [OpenAI::Models::Beta::MultiAgentConfigParam, nil]
-        #   Explicit configuration for creating and coordinating subagents.
+        #   Configuration for creating and coordinating subagents. Subagent tools are
+        #   disabled by default.
         #
         # @param name [String, nil]
         #   A human-readable name for the agent. Omission or null leaves the agent unnamed.
         #
         # @param reasoning [OpenAI::Models::Beta::AgentReasoningParam, nil]
-        #   Reasoning configuration for the agent.
+        #   Configuration for model reasoning. Omission uses the model's default effort.
         #
         # @param service_tier [Symbol, OpenAI::Models::Beta::AgentCreateParams::ServiceTier, nil]
-        #   The service tier used for model requests.
+        #   The service tier used for model requests. Defaults to `auto`.
         #
         # @param text [OpenAI::Models::Beta::AgentTextParam, nil]
-        #   Configuration for text generated by the agent.
+        #   Configuration for generated text. Defaults to the `text` format and medium
+        #   verbosity.
         #
         # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch>, nil]
         #   Tools available to the agent. Defaults to an empty list.
@@ -108,13 +110,14 @@ module OpenAI
         #   The model to use for the agent. The requested model name is preserved.
         #
         # @param multi_agent [OpenAI::Models::Beta::MultiAgentConfigParam, nil]
-        #   Explicit configuration for creating and coordinating subagents.
+        #   Configuration for creating and coordinating subagents.
         #
         # @param name [String, nil]
         #   A replacement name. Omit to leave unchanged, or pass null to clear it.
         #
         # @param reasoning [OpenAI::Models::Beta::AgentReasoningParam, nil]
-        #   Reasoning configuration for the agent.
+        #   Configuration for model reasoning. Omit to keep the current settings; pass
+        #   `null` to reset to the model's default effort.
         #
         # @param service_tier [Symbol, OpenAI::Models::Beta::AgentUpdateParams::ServiceTier, nil]
         #   The service tier used for model requests.

data/lib/openai/resources/beta/responses/input_items.rb

@@ -4,6 +4,7 @@ module OpenAI
   module Resources
     class Beta
       class Responses
+        # Create and manage model responses.
         class InputItems
           # Returns a list of input items for a given response.
           #

data/lib/openai/resources/beta/responses/input_tokens.rb

@@ -4,6 +4,7 @@ module OpenAI
   module Resources
     class Beta
       class Responses
+        # Create and manage model responses.
         class InputTokens
           # Returns input token counts of the request.
           #

data/lib/openai/resources/beta/responses.rb

@@ -3,10 +3,13 @@
 module OpenAI
   module Resources
     class Beta
+      # Create and manage model responses.
       class Responses
+        # Create and manage model responses.
         # @return [OpenAI::Resources::Beta::Responses::InputItems]
         attr_reader :input_items
 
+        # Create and manage model responses.
         # @return [OpenAI::Resources::Beta::Responses::InputTokens]
         attr_reader :input_tokens
 

data/lib/openai/resources/beta.rb

@@ -6,6 +6,7 @@ module OpenAI
       # @return [OpenAI::Resources::Beta::Agents]
       attr_reader :agents
 
+      # Create and manage model responses.
       # @return [OpenAI::Resources::Beta::Responses]
       attr_reader :responses
 

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

@@ -147,8 +147,11 @@ module OpenAI
         #   during tool use.
         #
         # @param prediction [OpenAI::Models::Chat::ChatCompletionPredictionContent, nil]
-        #   Static predicted output content, such as the content of a text file that is
-        #   being regenerated.
+        #   Configuration for a
+        #   [Predicted Output](https://developers.openai.com/api/docs/guides/predicted-outputs),
+        #   which can greatly improve response times when large parts of the model response
+        #   are known ahead of time. This is most common when you are regenerating a file
+        #   with only minor changes to most of the content.
         #
         # @param presence_penalty [Float, nil]
         #   Number between -2.0 and 2.0. Positive values penalize new tokens based on
@@ -516,8 +519,11 @@ module OpenAI
         #   during tool use.
         #
         # @param prediction [OpenAI::Models::Chat::ChatCompletionPredictionContent, nil]
-        #   Static predicted output content, such as the content of a text file that is
-        #   being regenerated.
+        #   Configuration for a
+        #   [Predicted Output](https://developers.openai.com/api/docs/guides/predicted-outputs),
+        #   which can greatly improve response times when large parts of the model response
+        #   are known ahead of time. This is most common when you are regenerating a file
+        #   with only minor changes to most of the content.
         #
         # @param presence_penalty [Float, nil]
         #   Number between -2.0 and 2.0. Positive values penalize new tokens based on

data/lib/openai/resources/conversations.rb

@@ -73,10 +73,9 @@ module OpenAI
       # @param metadata [Hash{Symbol=>String}, nil]
       #   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.
+      #   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.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/openai/resources/images.rb

@@ -103,10 +103,9 @@ module OpenAI
       #   set the output format to `png` or `webp`.
       #
       # @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
-      #   Control how much effort the model will exert to match the style and features,
-      #   especially facial features, of input images. This parameter is only supported
-      #   for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-      #   `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+      #   Controls fidelity to the original input image(s). This parameter is supported
+      #   for GPT image models that support input fidelity. `gpt-image-2` and
+      #   `gpt-image-2-2026-04-21` ignore this parameter.
       #
       # @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #   An additional image whose fully transparent areas (e.g. where alpha is zero)
@@ -245,10 +244,9 @@ module OpenAI
       #   set the output format to `png` or `webp`.
       #
       # @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
-      #   Control how much effort the model will exert to match the style and features,
-      #   especially facial features, of input images. This parameter is only supported
-      #   for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-      #   `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+      #   Controls fidelity to the original input image(s). This parameter is supported
+      #   for GPT image models that support input fidelity. `gpt-image-2` and
+      #   `gpt-image-2-2026-04-21` ignore this parameter.
       #
       # @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #   An additional image whose fully transparent areas (e.g. where alpha is zero)

data/lib/openai/resources/responses/input_items.rb

@@ -3,6 +3,7 @@
 module OpenAI
   module Resources
     class Responses
+      # Create and manage model responses.
       class InputItems
         # Returns a list of input items for a given response.
         #

data/lib/openai/resources/responses/input_tokens.rb

@@ -3,6 +3,7 @@
 module OpenAI
   module Resources
     class Responses
+      # Create and manage model responses.
       class InputTokens
         # Returns input token counts of the request.
         #

data/lib/openai/resources/responses.rb

@@ -4,10 +4,13 @@ require_relative "../helpers/structured_output/response_parser"
 
 module OpenAI
   module Resources
+    # Create and manage model responses.
     class Responses
+      # Create and manage model responses.
       # @return [OpenAI::Resources::Responses::InputItems]
       attr_reader :input_items
 
+      # Create and manage model responses.
       # @return [OpenAI::Resources::Responses::InputTokens]
       attr_reader :input_tokens
 

data/lib/openai/resources/safety/cases.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Safety
+      class Cases
+        # Get a safety case by ID.
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String]
+        #   Safety case ID
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::Safety::SafetyCase]
+        #
+        # @see OpenAI::Models::Safety::CaseRetrieveParams
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["safety/cases/%1$s", id],
+            model: OpenAI::Safety::SafetyCase,
+            security: {bearer_auth: true},
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [OpenAI::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/openai/resources/safety.rb

@@ -3,6 +3,9 @@
 module OpenAI
   module Resources
     class Safety
+      # @return [OpenAI::Resources::Safety::Cases]
+      attr_reader :cases
+
       # @return [OpenAI::Resources::Safety::Alerts]
       attr_reader :alerts
 
@@ -11,6 +14,7 @@ module OpenAI
       # @param client [OpenAI::Client]
       def initialize(client:)
         @client = client
+        @cases = OpenAI::Resources::Safety::Cases.new(client: client)
         @alerts = OpenAI::Resources::Safety::Alerts.new(client: client)
       end
     end

data/lib/openai/resources/webhooks/event_types.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Webhooks
+      class EventTypes
+        # Returns webhook event types visible to the authenticated project.
+        #
+        # @overload list(request_options: {})
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::Webhooks::WebhookEventTypeList]
+        #
+        # @see OpenAI::Models::Webhooks::EventTypeListParams
+        def list(params = {})
+          @client.request(
+            method: :get,
+            path: "webhook_event_types",
+            model: OpenAI::Webhooks::WebhookEventTypeList,
+            security: {bearer_auth: true},
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [OpenAI::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end