openai 0.63.0 → 0.65.0

data/rbi/openai/models/responses/response_output_item.rbi

@@ -20,6 +20,7 @@ module OpenAI
               OpenAI::Responses::ResponseReasoningItem,
               OpenAI::Responses::ResponseToolSearchCall,
               OpenAI::Responses::ResponseToolSearchOutputItem,
+              OpenAI::Responses::ResponseOutputItem::AdditionalTools,
               OpenAI::Responses::ResponseCompactionItem,
               OpenAI::Responses::ResponseOutputItem::ImageGenerationCall,
               OpenAI::Responses::ResponseCodeInterpreterToolCall,
@@ -38,6 +39,155 @@ module OpenAI
             )
           end
 
+        class AdditionalTools < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The unique ID of the additional tools item.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The role that provided the additional tools.
+          sig do
+            returns(
+              OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol
+            )
+          end
+          attr_accessor :role
+
+          # The additional tool definitions made available at this item.
+          sig { returns(T::Array[OpenAI::Responses::Tool::Variants]) }
+          attr_accessor :tools
+
+          # The type of the item. Always `additional_tools`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          sig do
+            params(
+              id: String,
+              role:
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::OrSymbol,
+              tools:
+                T::Array[
+                  T.any(
+                    OpenAI::Responses::FunctionTool::OrHash,
+                    OpenAI::Responses::FileSearchTool::OrHash,
+                    OpenAI::Responses::ComputerTool::OrHash,
+                    OpenAI::Responses::ComputerUsePreviewTool::OrHash,
+                    OpenAI::Responses::Tool::Mcp::OrHash,
+                    OpenAI::Responses::Tool::CodeInterpreter::OrHash,
+                    OpenAI::Responses::Tool::ImageGeneration::OrHash,
+                    OpenAI::Responses::Tool::LocalShell::OrHash,
+                    OpenAI::Responses::FunctionShellTool::OrHash,
+                    OpenAI::Responses::CustomTool::OrHash,
+                    OpenAI::Responses::NamespaceTool::OrHash,
+                    OpenAI::Responses::ToolSearchTool::OrHash,
+                    OpenAI::Responses::ApplyPatchTool::OrHash,
+                    OpenAI::Responses::WebSearchTool::OrHash,
+                    OpenAI::Responses::WebSearchPreviewTool::OrHash
+                  )
+                ],
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The unique ID of the additional tools item.
+            id:,
+            # The role that provided the additional tools.
+            role:,
+            # The additional tool definitions made available at this item.
+            tools:,
+            # The type of the item. Always `additional_tools`.
+            type: :additional_tools
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                role:
+                  OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol,
+                tools: T::Array[OpenAI::Responses::Tool::Variants],
+                type: Symbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The role that provided the additional tools.
+          module Role
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            UNKNOWN =
+              T.let(
+                :unknown,
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol
+              )
+            USER =
+              T.let(
+                :user,
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol
+              )
+            ASSISTANT =
+              T.let(
+                :assistant,
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol
+              )
+            SYSTEM =
+              T.let(
+                :system,
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol
+              )
+            CRITIC =
+              T.let(
+                :critic,
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol
+              )
+            DISCRIMINATOR =
+              T.let(
+                :discriminator,
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol
+              )
+            DEVELOPER =
+              T.let(
+                :developer,
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol
+              )
+            TOOL =
+              T.let(
+                :tool,
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::ResponseOutputItem::AdditionalTools::Role::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         class ImageGenerationCall < OpenAI::Internal::Type::BaseModel
           OrHash =
             T.type_alias do

data/rbi/openai/models/responses/response_output_item_added_event.rbi

@@ -43,6 +43,7 @@ module OpenAI
                 OpenAI::Responses::ResponseReasoningItem::OrHash,
                 OpenAI::Responses::ResponseToolSearchCall::OrHash,
                 OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::OrHash,
                 OpenAI::Responses::ResponseCompactionItem::OrHash,
                 OpenAI::Responses::ResponseOutputItem::ImageGenerationCall::OrHash,
                 OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,

data/rbi/openai/models/responses/response_output_item_done_event.rbi

@@ -43,6 +43,7 @@ module OpenAI
                 OpenAI::Responses::ResponseReasoningItem::OrHash,
                 OpenAI::Responses::ResponseToolSearchCall::OrHash,
                 OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
+                OpenAI::Responses::ResponseOutputItem::AdditionalTools::OrHash,
                 OpenAI::Responses::ResponseCompactionItem::OrHash,
                 OpenAI::Responses::ResponseOutputItem::ImageGenerationCall::OrHash,
                 OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,

data/rbi/openai/models/responses/responses_client_event.rbi

@@ -190,6 +190,14 @@ module OpenAI
         # prompt caching, which keeps cached prefixes active for longer, up to a maximum
         # of 24 hours.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+        # For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+        #
+        # For older models that support both `in_memory` and `24h`, the default depends on
+        # your organization's data retention policy:
+        #
+        # - Organizations without ZDR enabled default to `24h`.
+        # - Organizations with ZDR enabled default to `in_memory` when
+        #   `prompt_cache_retention` is not specified.
         sig do
           returns(
             T.nilable(
@@ -626,6 +634,14 @@ module OpenAI
           # prompt caching, which keeps cached prefixes active for longer, up to a maximum
           # of 24 hours.
           # [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+          # For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+          #
+          # For older models that support both `in_memory` and `24h`, the default depends on
+          # your organization's data retention policy:
+          #
+          # - Organizations without ZDR enabled default to `24h`.
+          # - Organizations with ZDR enabled default to `in_memory` when
+          #   `prompt_cache_retention` is not specified.
           prompt_cache_retention: nil,
           # **gpt-5 and o-series models only**
           #
@@ -922,6 +938,14 @@ module OpenAI
         # prompt caching, which keeps cached prefixes active for longer, up to a maximum
         # of 24 hours.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+        # For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+        #
+        # For older models that support both `in_memory` and `24h`, the default depends on
+        # your organization's data retention policy:
+        #
+        # - Organizations without ZDR enabled default to `24h`.
+        # - Organizations with ZDR enabled default to `in_memory` when
+        #   `prompt_cache_retention` is not specified.
         module PromptCacheRetention
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/resources/admin/organization/data_retention.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class DataRetention
+          # Retrieves organization data retention controls.
+          sig do
+            params(request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Admin::Organization::OrganizationDataRetention
+            )
+          end
+          def retrieve(request_options: {})
+          end
+
+          # Updates organization data retention controls.
+          sig do
+            params(
+              retention_type:
+                OpenAI::Admin::Organization::DataRetentionUpdateParams::RetentionType::OrSymbol,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Admin::Organization::OrganizationDataRetention)
+          end
+          def update(
+            # The desired organization data retention type.
+            retention_type:,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/admin/organization/groups/roles.rbi

@@ -25,6 +25,25 @@ module OpenAI
             )
             end
 
+            # Retrieves an organization role assigned to a group.
+            sig do
+              params(
+                role_id: String,
+                group_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Models::Admin::Organization::Groups::RoleRetrieveResponse
+              )
+            end
+            def retrieve(
+              # The ID of the organization role to retrieve for the group.
+              role_id,
+              # The ID of the group to inspect.
+              group_id:,
+              request_options: {}
+            )
+            end
+
             # Lists the organization roles assigned to a group within the organization.
             sig do
               params(

data/rbi/openai/resources/admin/organization/groups/users.rbi

@@ -25,6 +25,25 @@ module OpenAI
             )
             end
 
+            # Retrieves a user in a group.
+            sig do
+              params(
+                user_id: String,
+                group_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Models::Admin::Organization::Groups::UserRetrieveResponse
+              )
+            end
+            def retrieve(
+              # The ID of the user to retrieve from the group.
+              user_id,
+              # The ID of the group to inspect.
+              group_id:,
+              request_options: {}
+            )
+            end
+
             # Lists the users assigned to a group.
             sig do
               params(

data/rbi/openai/resources/admin/organization/groups.rbi

@@ -25,6 +25,20 @@ module OpenAI
           )
           end
 
+          # Retrieves a group.
+          sig do
+            params(
+              group_id: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Admin::Organization::Group)
+          end
+          def retrieve(
+            # The ID of the group to retrieve.
+            group_id,
+            request_options: {}
+          )
+          end
+
           # Updates a group's information.
           sig do
             params(

data/rbi/openai/resources/admin/organization/invites.rbi

@@ -26,7 +26,8 @@ module OpenAI
             role:,
             # An array of projects to which membership is granted at the same time the org
             # invite is accepted. If omitted, the user will be invited to the default project
-            # for compatibility with legacy behavior.
+            # for compatibility with legacy behavior. If empty list is passed, the user will
+            # not be invited to any projects, including the default one.
             projects: nil,
             request_options: {}
           )

data/rbi/openai/resources/admin/organization/projects/data_retention.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class Projects
+          class DataRetention
+            # Retrieves project data retention controls.
+            sig do
+              params(
+                project_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectDataRetention
+              )
+            end
+            def retrieve(
+              # The ID of the project to inspect.
+              project_id,
+              request_options: {}
+            )
+            end
+
+            # Updates project data retention controls.
+            sig do
+              params(
+                project_id: String,
+                retention_type:
+                  OpenAI::Admin::Organization::Projects::DataRetentionUpdateParams::RetentionType::OrSymbol,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectDataRetention
+              )
+            end
+            def update(
+              # The ID of the project to update.
+              project_id,
+              # The desired project data retention type.
+              retention_type:,
+              request_options: {}
+            )
+            end
+
+            # @api private
+            sig { params(client: OpenAI::Client).returns(T.attached_class) }
+            def self.new(client:)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/admin/organization/projects/groups/roles.rbi

@@ -29,6 +29,28 @@ module OpenAI
               )
               end
 
+              # Retrieves a project role assigned to a group.
+              sig do
+                params(
+                  role_id: String,
+                  project_id: String,
+                  group_id: String,
+                  request_options: OpenAI::RequestOptions::OrHash
+                ).returns(
+                  OpenAI::Models::Admin::Organization::Projects::Groups::RoleRetrieveResponse
+                )
+              end
+              def retrieve(
+                # The ID of the project role to retrieve for the group.
+                role_id,
+                # The ID of the project to inspect.
+                project_id:,
+                # The ID of the group to inspect.
+                group_id:,
+                request_options: {}
+              )
+              end
+
               # Lists the project roles assigned to a group within a project.
               sig do
                 params(

data/rbi/openai/resources/admin/organization/projects/groups.rbi

@@ -33,6 +33,27 @@ module OpenAI
             )
             end
 
+            # Retrieves a project's group.
+            sig do
+              params(
+                group_id: String,
+                project_id: String,
+                group_type:
+                  OpenAI::Admin::Organization::Projects::GroupRetrieveParams::GroupType::OrSymbol,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(OpenAI::Admin::Organization::Projects::ProjectGroup)
+            end
+            def retrieve(
+              # Path param: The ID of the group to retrieve.
+              group_id,
+              # Path param: The ID of the project to inspect.
+              project_id:,
+              # Query param: The type of group to retrieve.
+              group_type: nil,
+              request_options: {}
+            )
+            end
+
             # Lists the groups that have access to a project.
             sig do
               params(

data/rbi/openai/resources/admin/organization/projects/hosted_tool_permissions.rbi

@@ -0,0 +1,80 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class Projects
+          class HostedToolPermissions
+            # Returns hosted tool permissions for a project.
+            sig do
+              params(
+                project_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectHostedToolPermissions
+              )
+            end
+            def retrieve(
+              # The ID of the project.
+              project_id,
+              request_options: {}
+            )
+            end
+
+            # Updates hosted tool permissions for a project.
+            sig do
+              params(
+                project_id: String,
+                code_interpreter:
+                  T.nilable(
+                    OpenAI::Admin::Organization::Projects::HostedToolPermissionUpdateParams::CodeInterpreter::OrHash
+                  ),
+                file_search:
+                  T.nilable(
+                    OpenAI::Admin::Organization::Projects::HostedToolPermissionUpdateParams::FileSearch::OrHash
+                  ),
+                image_generation:
+                  T.nilable(
+                    OpenAI::Admin::Organization::Projects::HostedToolPermissionUpdateParams::ImageGeneration::OrHash
+                  ),
+                mcp:
+                  T.nilable(
+                    OpenAI::Admin::Organization::Projects::HostedToolPermissionUpdateParams::Mcp::OrHash
+                  ),
+                web_search:
+                  T.nilable(
+                    OpenAI::Admin::Organization::Projects::HostedToolPermissionUpdateParams::WebSearch::OrHash
+                  ),
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectHostedToolPermissions
+              )
+            end
+            def update(
+              # The ID of the project.
+              project_id,
+              # The code interpreter permission update.
+              code_interpreter: nil,
+              # The file search permission update.
+              file_search: nil,
+              # The image generation permission update.
+              image_generation: nil,
+              # The MCP permission update.
+              mcp: nil,
+              # The web search permission update.
+              web_search: nil,
+              request_options: {}
+            )
+            end
+
+            # @api private
+            sig { params(client: OpenAI::Client).returns(T.attached_class) }
+            def self.new(client:)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/admin/organization/projects/model_permissions.rbi

@@ -0,0 +1,73 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class Projects
+          class ModelPermissions
+            # Returns model permissions for a project.
+            sig do
+              params(
+                project_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectModelPermissions
+              )
+            end
+            def retrieve(
+              # The ID of the project.
+              project_id,
+              request_options: {}
+            )
+            end
+
+            # Updates model permissions for a project.
+            sig do
+              params(
+                project_id: String,
+                mode:
+                  OpenAI::Admin::Organization::Projects::ModelPermissionUpdateParams::Mode::OrSymbol,
+                model_ids: T::Array[String],
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectModelPermissions
+              )
+            end
+            def update(
+              # The ID of the project.
+              project_id,
+              # The model permissions mode to apply.
+              mode:,
+              # The model IDs included in this permissions policy.
+              model_ids:,
+              request_options: {}
+            )
+            end
+
+            # Deletes model permissions for a project.
+            sig do
+              params(
+                project_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectModelPermissionsDeleted
+              )
+            end
+            def delete(
+              # The ID of the project.
+              project_id,
+              request_options: {}
+            )
+            end
+
+            # @api private
+            sig { params(client: OpenAI::Client).returns(T.attached_class) }
+            def self.new(client:)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/admin/organization/projects/roles.rbi

@@ -29,6 +29,23 @@ module OpenAI
             )
             end
 
+            # Retrieves a project role.
+            sig do
+              params(
+                role_id: String,
+                project_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(OpenAI::Admin::Organization::Role)
+            end
+            def retrieve(
+              # The ID of the role to retrieve.
+              role_id,
+              # The ID of the project.
+              project_id:,
+              request_options: {}
+            )
+            end
+
             # Updates an existing project role.
             sig do
               params(

data/rbi/openai/resources/admin/organization/projects/service_accounts.rbi

@@ -45,6 +45,32 @@ module OpenAI
             )
             end
 
+            # Updates a service account in the project.
+            sig do
+              params(
+                service_account_id: String,
+                project_id: String,
+                name: String,
+                role:
+                  OpenAI::Admin::Organization::Projects::ServiceAccountUpdateParams::Role::OrSymbol,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectServiceAccount
+              )
+            end
+            def update(
+              # Path param: The ID of the service account.
+              service_account_id,
+              # Path param: The ID of the project.
+              project_id:,
+              # Body param: The updated service account name.
+              name: nil,
+              # Body param: The updated service account role.
+              role: nil,
+              request_options: {}
+            )
+            end
+
             # Returns a list of service accounts in the project.
             sig do
               params(