openai 0.66.1 → 0.68.0

data/lib/openai/models/realtime/realtime_tools_config_union.rb

@@ -48,8 +48,8 @@ module OpenAI
 
           # @!attribute connector_id
           #   Identifier for service connectors, like those available in ChatGPT. One of
-          #   `server_url` or `connector_id` must be provided. Learn more about service
-          #   connectors
+          #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          #   service connectors
           #   [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           #   Currently supported `connector_id` values are:
@@ -94,13 +94,20 @@ module OpenAI
           optional :server_description, String
 
           # @!attribute server_url
-          #   The URL for the MCP server. One of `server_url` or `connector_id` must be
-          #   provided.
+          #   The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+          #   must be provided.
           #
           #   @return [String, nil]
           optional :server_url, String
 
-          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
+          # @!attribute tunnel_id
+          #   The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+          #   `server_url`, `connector_id`, or `tunnel_id` must be provided.
+          #
+          #   @return [String, nil]
+          optional :tunnel_id, String
+
+          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, tunnel_id: nil, type: :mcp)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp} for more details.
           #
@@ -124,7 +131,9 @@ module OpenAI
           #
           #   @param server_description [String] Optional description of the MCP server, used to provide more context.
           #
-          #   @param server_url [String] The URL for the MCP server. One of `server_url` or `connector_id` must be
+          #   @param server_url [String] The URL for the MCP server. One of `server_url`, `connector_id`, or
+          #
+          #   @param tunnel_id [String] The Secure MCP Tunnel ID to use instead of a direct server URL. One of
           #
           #   @param type [Symbol, :mcp] The type of the MCP tool. Always `mcp`.
 
@@ -176,8 +185,8 @@ module OpenAI
           end
 
           # Identifier for service connectors, like those available in ChatGPT. One of
-          # `server_url` or `connector_id` must be provided. Learn more about service
-          # connectors
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          # service connectors
           # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           # Currently supported `connector_id` values are:

data/lib/openai/models/reasoning.rb

@@ -3,6 +3,14 @@
 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.
+      #   When returned on a response, this is the effective reasoning context mode used
+      #   for the response.
+      #
+      #   @return [Symbol, OpenAI::Models::Reasoning::Context, nil]
+      optional :context, enum: -> { OpenAI::Reasoning::Context }, nil?: true
+
       # @!attribute effort
       #   Constrains effort on reasoning for
       #   [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
@@ -44,7 +52,7 @@ module OpenAI
       #   @return [Symbol, OpenAI::Models::Reasoning::Summary, nil]
       optional :summary, enum: -> { OpenAI::Reasoning::Summary }, nil?: true
 
-      # @!method initialize(effort: nil, generate_summary: nil, summary: nil)
+      # @!method initialize(context: nil, effort: nil, generate_summary: nil, summary: nil)
       #   Some parameter documentations has been truncated, see
       #   {OpenAI::Models::Reasoning} for more details.
       #
@@ -53,12 +61,30 @@ module OpenAI
       #   Configuration options for
       #   [reasoning models](https://platform.openai.com/docs/guides/reasoning).
       #
+      #   @param context [Symbol, OpenAI::Models::Reasoning::Context, nil] Controls which reasoning items are rendered back to the model on later turns.
+      #
       #   @param effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
       #
       #   @param generate_summary [Symbol, OpenAI::Models::Reasoning::GenerateSummary, nil] **Deprecated:** use `summary` instead.
       #
       #   @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.
+      # When returned on a response, this is the effective reasoning context mode used
+      # for the response.
+      #
+      # @see OpenAI::Models::Reasoning#context
+      module Context
+        extend OpenAI::Internal::Type::Enum
+
+        AUTO = :auto
+        CURRENT_TURN = :current_turn
+        ALL_TURNS = :all_turns
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # @deprecated
       #
       # **Deprecated:** use `summary` instead.

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

@@ -100,6 +100,8 @@ module OpenAI
         optional :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::Tool] }, nil?: true
 
         # @!attribute truncation
+        #   @deprecated
+        #
         #   The truncation strategy to use for the model response. - `auto`: If the input to
         #   this Response exceeds the model's context window size, the model will truncate
         #   the response to fit the context window by dropping items from the beginning of
@@ -303,6 +305,8 @@ module OpenAI
           #   @return [Array(Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom, OpenAI::Models::Responses::ToolChoiceApplyPatch, OpenAI::Models::Responses::ToolChoiceShell)]
         end
 
+        # @deprecated
+        #
         # The truncation strategy to use for the model response. - `auto`: If the input to
         # this Response exceeds the model's context window size, the model will truncate
         # the response to fit the context window by dropping items from the beginning of

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

@@ -311,6 +311,8 @@ module OpenAI
         optional :top_p, Float, nil?: true
 
         # @!attribute truncation
+        #   @deprecated
+        #
         #   The truncation strategy to use for the model response.
         #
         #   - `auto`: If the input to this Response exceeds the model's context window size,
@@ -590,6 +592,8 @@ module OpenAI
           #   @return [Array(Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom, OpenAI::Models::Responses::ToolChoiceApplyPatch, OpenAI::Models::Responses::ToolChoiceShell)]
         end
 
+        # @deprecated
+        #
         # The truncation strategy to use for the model response.
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,

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

@@ -316,6 +316,8 @@ module OpenAI
         optional :top_p, Float, nil?: true
 
         # @!attribute truncation
+        #   @deprecated
+        #
         #   The truncation strategy to use for the model response.
         #
         #   - `auto`: If the input to this Response exceeds the model's context window size,
@@ -609,6 +611,8 @@ module OpenAI
           #   @return [Array(Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom, OpenAI::Models::Responses::ToolChoiceApplyPatch, OpenAI::Models::Responses::ToolChoiceShell)]
         end
 
+        # @deprecated
+        #
         # The truncation strategy to use for the model response.
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,

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

@@ -87,8 +87,8 @@ module OpenAI
 
           # @!attribute connector_id
           #   Identifier for service connectors, like those available in ChatGPT. One of
-          #   `server_url` or `connector_id` must be provided. Learn more about service
-          #   connectors
+          #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          #   service connectors
           #   [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           #   Currently supported `connector_id` values are:
@@ -131,13 +131,20 @@ module OpenAI
           optional :server_description, String
 
           # @!attribute server_url
-          #   The URL for the MCP server. One of `server_url` or `connector_id` must be
-          #   provided.
+          #   The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+          #   must be provided.
           #
           #   @return [String, nil]
           optional :server_url, String
 
-          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
+          # @!attribute tunnel_id
+          #   The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+          #   `server_url`, `connector_id`, or `tunnel_id` must be provided.
+          #
+          #   @return [String, nil]
+          optional :tunnel_id, String
+
+          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, tunnel_id: nil, type: :mcp)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::Tool::Mcp} for more details.
           #
@@ -161,7 +168,9 @@ module OpenAI
           #
           #   @param server_description [String] Optional description of the MCP server, used to provide more context.
           #
-          #   @param server_url [String] The URL for the MCP server. One of `server_url` or `connector_id` must be
+          #   @param server_url [String] The URL for the MCP server. One of `server_url`, `connector_id`, or
+          #
+          #   @param tunnel_id [String] The Secure MCP Tunnel ID to use instead of a direct server URL. One of
           #
           #   @param type [Symbol, :mcp] The type of the MCP tool. Always `mcp`.
 
@@ -213,8 +222,8 @@ module OpenAI
           end
 
           # Identifier for service connectors, like those available in ChatGPT. One of
-          # `server_url` or `connector_id` must be provided. Learn more about service
-          # connectors
+          # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+          # service connectors
           # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
           #
           # Currently supported `connector_id` values are:

data/lib/openai/models/video_create_params.rb

@@ -62,6 +62,7 @@ module OpenAI
         # Optional reference asset upload or reference object that guides generation.
         variant OpenAI::Internal::Type::FileInput
 
+        # Optional reference asset upload or reference object that guides generation. Provide exactly one of `image_url` or `file_id` when using an object.
         variant -> { OpenAI::ImageInputReferenceParam }
 
         # @!method self.variants

data/lib/openai/models/video_edit_params.rb

@@ -33,7 +33,7 @@ module OpenAI
         # Reference to the completed video to edit.
         variant OpenAI::Internal::Type::FileInput
 
-        # Reference to the completed video.
+        # Reference to the completed video to edit.
         variant -> { OpenAI::VideoEditParams::Video::VideoReferenceInputParam }
 
         class VideoReferenceInputParam < OpenAI::Internal::Type::BaseModel
@@ -44,7 +44,7 @@ module OpenAI
           required :id, String
 
           # @!method initialize(id:)
-          #   Reference to the completed video.
+          #   Reference to the completed video to edit.
           #
           #   @param id [String] The identifier of the completed video.
         end

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

@@ -5,11 +5,17 @@ module OpenAI
     class Admin
       class Organization
         class AdminAPIKeys
+          # Some parameter documentations has been truncated, see
+          # {OpenAI::Models::Admin::Organization::AdminAPIKeyCreateParams} for more details.
+          #
           # Create an organization admin API key
           #
-          # @overload create(name:, request_options: {})
+          # @overload create(name:, expires_in_seconds: nil, request_options: {})
           #
           # @param name [String]
+          #
+          # @param expires_in_seconds [Integer] The number of seconds until the API key expires. Omit this field for a key that
+          #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [OpenAI::Models::Admin::Organization::AdminAPIKeyCreateResponse]

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

@@ -11,7 +11,7 @@ module OpenAI
           #
           # List user actions and configuration changes within this organization.
           #
-          # @overload list(actor_emails: nil, actor_ids: nil, after: nil, before: nil, effective_at: nil, event_types: nil, limit: nil, project_ids: nil, resource_ids: nil, request_options: {})
+          # @overload list(actor_emails: nil, actor_ids: nil, after: nil, before: nil, effective_at: nil, event_types: nil, limit: nil, project_ids: nil, resource_ids: nil, tenant_only: nil, request_options: {})
           #
           # @param actor_emails [Array<String>] Return only events performed by users with these emails.
           #
@@ -31,6 +31,8 @@ module OpenAI
           #
           # @param resource_ids [Array<String>] Return only events performed on these targets. For example, a project ID updated
           #
+          # @param tenant_only [Boolean] Return only tenant-scoped events associated with this organization. Required for
+          #
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [OpenAI::Internal::ConversationCursorPage<OpenAI::Models::Admin::Organization::AuditLogListResponse>]

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

@@ -37,6 +37,34 @@ module OpenAI
               )
             end
 
+            # Retrieves a project spend alert.
+            #
+            # @overload retrieve(alert_id, project_id:, request_options: {})
+            #
+            # @param alert_id [String] The ID of the spend alert to retrieve.
+            #
+            # @param project_id [String] The ID of the project.
+            #
+            # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [OpenAI::Models::Admin::Organization::Projects::ProjectSpendAlert]
+            #
+            # @see OpenAI::Models::Admin::Organization::Projects::SpendAlertRetrieveParams
+            def retrieve(alert_id, params)
+              parsed, options = OpenAI::Admin::Organization::Projects::SpendAlertRetrieveParams.dump_request(params)
+              project_id =
+                parsed.delete(:project_id) do
+                  raise ArgumentError.new("missing required path argument #{_1}")
+                end
+              @client.request(
+                method: :get,
+                path: ["organization/projects/%1$s/spend_alerts/%2$s", project_id, alert_id],
+                model: OpenAI::Admin::Organization::Projects::ProjectSpendAlert,
+                security: {admin_api_key_auth: true},
+                options: options
+              )
+            end
+
             # Updates a project spend alert.
             #
             # @overload update(alert_id, project_id:, currency:, interval:, notification_channel:, threshold_amount:, request_options: {})

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

@@ -34,6 +34,27 @@ module OpenAI
             )
           end
 
+          # Retrieves an organization spend alert.
+          #
+          # @overload retrieve(alert_id, request_options: {})
+          #
+          # @param alert_id [String] The ID of the spend alert to retrieve.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Admin::Organization::OrganizationSpendAlert]
+          #
+          # @see OpenAI::Models::Admin::Organization::SpendAlertRetrieveParams
+          def retrieve(alert_id, params = {})
+            @client.request(
+              method: :get,
+              path: ["organization/spend_alerts/%1$s", alert_id],
+              model: OpenAI::Admin::Organization::OrganizationSpendAlert,
+              security: {admin_api_key_auth: true},
+              options: params[:request_options]
+            )
+          end
+
           # Updates an organization spend alert.
           #
           # @overload update(alert_id, currency:, interval:, notification_channel:, threshold_amount:, request_options: {})

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.66.1"
+  VERSION = "0.68.0"
 end

data/lib/openai.rb

@@ -206,6 +206,7 @@ require_relative "openai/models/admin/organization/projects/service_account_upda
 require_relative "openai/models/admin/organization/projects/spend_alert_create_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_delete_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_list_params"
+require_relative "openai/models/admin/organization/projects/spend_alert_retrieve_params"
 require_relative "openai/models/admin/organization/projects/spend_alert_update_params"
 require_relative "openai/models/admin/organization/projects/user_create_params"
 require_relative "openai/models/admin/organization/projects/user_delete_params"
@@ -232,6 +233,7 @@ require_relative "openai/models/admin/organization/role_update_params"
 require_relative "openai/models/admin/organization/spend_alert_create_params"
 require_relative "openai/models/admin/organization/spend_alert_delete_params"
 require_relative "openai/models/admin/organization/spend_alert_list_params"
+require_relative "openai/models/admin/organization/spend_alert_retrieve_params"
 require_relative "openai/models/admin/organization/spend_alert_update_params"
 require_relative "openai/models/admin/organization/usage_audio_speeches_params"
 require_relative "openai/models/admin/organization/usage_audio_speeches_response"

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

@@ -21,6 +21,10 @@ module OpenAI
           sig { returns(Integer) }
           attr_accessor :created_at
 
+          # The Unix timestamp (in seconds) of when the API key expires
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :expires_at
+
           # The object type, which is always `organization.admin_api_key`
           sig { returns(Symbol) }
           attr_accessor :object
@@ -52,6 +56,7 @@ module OpenAI
             params(
               id: String,
               created_at: Integer,
+              expires_at: T.nilable(Integer),
               owner: OpenAI::Admin::Organization::AdminAPIKey::Owner::OrHash,
               redacted_value: String,
               last_used_at: T.nilable(Integer),
@@ -64,6 +69,8 @@ module OpenAI
             id:,
             # The Unix timestamp (in seconds) of when the API key was created
             created_at:,
+            # The Unix timestamp (in seconds) of when the API key expires
+            expires_at:,
             owner:,
             # The redacted value of the API key
             redacted_value:,
@@ -81,6 +88,7 @@ module OpenAI
               {
                 id: String,
                 created_at: Integer,
+                expires_at: T.nilable(Integer),
                 object: Symbol,
                 owner: OpenAI::Admin::Organization::AdminAPIKey::Owner,
                 redacted_value: String,

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

@@ -19,18 +19,37 @@ module OpenAI
           sig { returns(String) }
           attr_accessor :name
 
+          # The number of seconds until the API key expires. Omit this field for a key that
+          # does not expire.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :expires_in_seconds
+
+          sig { params(expires_in_seconds: Integer).void }
+          attr_writer :expires_in_seconds
+
           sig do
             params(
               name: String,
+              expires_in_seconds: Integer,
               request_options: OpenAI::RequestOptions::OrHash
             ).returns(T.attached_class)
           end
-          def self.new(name:, request_options: {})
+          def self.new(
+            name:,
+            # The number of seconds until the API key expires. Omit this field for a key that
+            # does not expire.
+            expires_in_seconds: nil,
+            request_options: {}
+          )
           end
 
           sig do
             override.returns(
-              { name: String, request_options: OpenAI::RequestOptions }
+              {
+                name: String,
+                expires_in_seconds: Integer,
+                request_options: OpenAI::RequestOptions
+              }
             )
           end
           def to_hash

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

@@ -109,13 +109,24 @@ module OpenAI
           attr_writer :project_ids
 
           # Return only events performed on these targets. For example, a project ID
-          # updated.
+          # updated. For ChatGPT connector role events, use the workspace connector resource
+          # ID shown in `details.id`, such as `<workspace_id>__<connector_id>`.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :resource_ids
 
           sig { params(resource_ids: T::Array[String]).void }
           attr_writer :resource_ids
 
+          # Return only tenant-scoped events associated with this organization. Required for
+          # tenant-scoped events such as `role.bound_to_resource` and
+          # `role.unbound_from_resource`. When `true`, all supplied event types must be
+          # tenant-scoped.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :tenant_only
+
+          sig { params(tenant_only: T::Boolean).void }
+          attr_writer :tenant_only
+
           sig do
             params(
               actor_emails: T::Array[String],
@@ -131,6 +142,7 @@ module OpenAI
               limit: Integer,
               project_ids: T::Array[String],
               resource_ids: T::Array[String],
+              tenant_only: T::Boolean,
               request_options: OpenAI::RequestOptions::OrHash
             ).returns(T.attached_class)
           end
@@ -162,8 +174,14 @@ module OpenAI
             # Return only events for these projects.
             project_ids: nil,
             # Return only events performed on these targets. For example, a project ID
-            # updated.
+            # updated. For ChatGPT connector role events, use the workspace connector resource
+            # ID shown in `details.id`, such as `<workspace_id>__<connector_id>`.
             resource_ids: nil,
+            # Return only tenant-scoped events associated with this organization. Required for
+            # tenant-scoped events such as `role.bound_to_resource` and
+            # `role.unbound_from_resource`. When `true`, all supplied event types must be
+            # tenant-scoped.
+            tenant_only: nil,
             request_options: {}
           )
           end
@@ -184,6 +202,7 @@ module OpenAI
                 limit: Integer,
                 project_ids: T::Array[String],
                 resource_ids: T::Array[String],
+                tenant_only: T::Boolean,
                 request_options: OpenAI::RequestOptions
               }
             )
@@ -522,6 +541,16 @@ module OpenAI
                 :"role.assignment.deleted",
                 OpenAI::Admin::Organization::AuditLogListParams::EventType::TaggedSymbol
               )
+            ROLE_BOUND_TO_RESOURCE =
+              T.let(
+                :"role.bound_to_resource",
+                OpenAI::Admin::Organization::AuditLogListParams::EventType::TaggedSymbol
+              )
+            ROLE_UNBOUND_FROM_RESOURCE =
+              T.let(
+                :"role.unbound_from_resource",
+                OpenAI::Admin::Organization::AuditLogListParams::EventType::TaggedSymbol
+              )
             SCIM_ENABLED =
               T.let(
                 :"scim.enabled",