openai 0.63.0 → 0.64.0

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(

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

@@ -0,0 +1,135 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class Projects
+          class SpendAlerts
+            # Creates a project spend alert.
+            sig do
+              params(
+                project_id: String,
+                currency:
+                  OpenAI::Admin::Organization::Projects::SpendAlertCreateParams::Currency::OrSymbol,
+                interval:
+                  OpenAI::Admin::Organization::Projects::SpendAlertCreateParams::Interval::OrSymbol,
+                notification_channel:
+                  OpenAI::Admin::Organization::Projects::SpendAlertCreateParams::NotificationChannel::OrHash,
+                threshold_amount: Integer,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectSpendAlert
+              )
+            end
+            def create(
+              # The ID of the project to update.
+              project_id,
+              # The currency for the threshold amount.
+              currency:,
+              # The time interval for evaluating spend against the threshold.
+              interval:,
+              # Email notification settings for a spend alert.
+              notification_channel:,
+              # The alert threshold amount, in cents.
+              threshold_amount:,
+              request_options: {}
+            )
+            end
+
+            # Updates a project spend alert.
+            sig do
+              params(
+                alert_id: String,
+                project_id: String,
+                currency:
+                  OpenAI::Admin::Organization::Projects::SpendAlertUpdateParams::Currency::OrSymbol,
+                interval:
+                  OpenAI::Admin::Organization::Projects::SpendAlertUpdateParams::Interval::OrSymbol,
+                notification_channel:
+                  OpenAI::Admin::Organization::Projects::SpendAlertUpdateParams::NotificationChannel::OrHash,
+                threshold_amount: Integer,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectSpendAlert
+              )
+            end
+            def update(
+              # Path param: The ID of the spend alert to update.
+              alert_id,
+              # Path param: The ID of the project to update.
+              project_id:,
+              # Body param: The currency for the threshold amount.
+              currency:,
+              # Body param: The time interval for evaluating spend against the threshold.
+              interval:,
+              # Body param: Email notification settings for a spend alert.
+              notification_channel:,
+              # Body param: The alert threshold amount, in cents.
+              threshold_amount:,
+              request_options: {}
+            )
+            end
+
+            # Lists project spend alerts.
+            sig do
+              params(
+                project_id: String,
+                after: String,
+                before: String,
+                limit: Integer,
+                order:
+                  OpenAI::Admin::Organization::Projects::SpendAlertListParams::Order::OrSymbol,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Internal::ConversationCursorPage[
+                  OpenAI::Admin::Organization::Projects::ProjectSpendAlert
+                ]
+              )
+            end
+            def list(
+              # The ID of the project to inspect.
+              project_id,
+              # Cursor for pagination. Provide the ID of the last spend alert from the previous
+              # response to fetch the next page.
+              after: nil,
+              # Cursor for pagination. Provide the ID of the first spend alert from the previous
+              # response to fetch the previous page.
+              before: nil,
+              # A limit on the number of spend alerts to return. Defaults to 20.
+              limit: nil,
+              # Sort order for the returned spend alerts.
+              order: nil,
+              request_options: {}
+            )
+            end
+
+            # Deletes a project spend alert.
+            sig do
+              params(
+                alert_id: String,
+                project_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Admin::Organization::Projects::ProjectSpendAlertDeleted
+              )
+            end
+            def delete(
+              # The ID of the spend alert to delete.
+              alert_id,
+              # The ID of the project to update.
+              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/users/roles.rbi

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

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

@@ -29,6 +29,20 @@ module OpenAI
           end
           attr_reader :rate_limits
 
+          sig do
+            returns(
+              OpenAI::Resources::Admin::Organization::Projects::ModelPermissions
+            )
+          end
+          attr_reader :model_permissions
+
+          sig do
+            returns(
+              OpenAI::Resources::Admin::Organization::Projects::HostedToolPermissions
+            )
+          end
+          attr_reader :hosted_tool_permissions
+
           sig do
             returns(OpenAI::Resources::Admin::Organization::Projects::Groups)
           end
@@ -39,6 +53,20 @@ module OpenAI
           end
           attr_reader :roles
 
+          sig do
+            returns(
+              OpenAI::Resources::Admin::Organization::Projects::DataRetention
+            )
+          end
+          attr_reader :data_retention
+
+          sig do
+            returns(
+              OpenAI::Resources::Admin::Organization::Projects::SpendAlerts
+            )
+          end
+          attr_reader :spend_alerts
+
           sig do
             returns(
               OpenAI::Resources::Admin::Organization::Projects::Certificates

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

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

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

@@ -0,0 +1,117 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class SpendAlerts
+          # Creates an organization spend alert.
+          sig do
+            params(
+              currency:
+                OpenAI::Admin::Organization::SpendAlertCreateParams::Currency::OrSymbol,
+              interval:
+                OpenAI::Admin::Organization::SpendAlertCreateParams::Interval::OrSymbol,
+              notification_channel:
+                OpenAI::Admin::Organization::SpendAlertCreateParams::NotificationChannel::OrHash,
+              threshold_amount: Integer,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Admin::Organization::OrganizationSpendAlert)
+          end
+          def create(
+            # The currency for the threshold amount.
+            currency:,
+            # The time interval for evaluating spend against the threshold.
+            interval:,
+            # Email notification settings for a spend alert.
+            notification_channel:,
+            # The alert threshold amount, in cents.
+            threshold_amount:,
+            request_options: {}
+          )
+          end
+
+          # Updates an organization spend alert.
+          sig do
+            params(
+              alert_id: String,
+              currency:
+                OpenAI::Admin::Organization::SpendAlertUpdateParams::Currency::OrSymbol,
+              interval:
+                OpenAI::Admin::Organization::SpendAlertUpdateParams::Interval::OrSymbol,
+              notification_channel:
+                OpenAI::Admin::Organization::SpendAlertUpdateParams::NotificationChannel::OrHash,
+              threshold_amount: Integer,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Admin::Organization::OrganizationSpendAlert)
+          end
+          def update(
+            # The ID of the spend alert to update.
+            alert_id,
+            # The currency for the threshold amount.
+            currency:,
+            # The time interval for evaluating spend against the threshold.
+            interval:,
+            # Email notification settings for a spend alert.
+            notification_channel:,
+            # The alert threshold amount, in cents.
+            threshold_amount:,
+            request_options: {}
+          )
+          end
+
+          # Lists organization spend alerts.
+          sig do
+            params(
+              after: String,
+              before: String,
+              limit: Integer,
+              order:
+                OpenAI::Admin::Organization::SpendAlertListParams::Order::OrSymbol,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Internal::ConversationCursorPage[
+                OpenAI::Admin::Organization::OrganizationSpendAlert
+              ]
+            )
+          end
+          def list(
+            # Cursor for pagination. Provide the ID of the last spend alert from the previous
+            # response to fetch the next page.
+            after: nil,
+            # Cursor for pagination. Provide the ID of the first spend alert from the previous
+            # response to fetch the previous page.
+            before: nil,
+            # A limit on the number of spend alerts to return. Defaults to 20.
+            limit: nil,
+            # Sort order for the returned spend alerts.
+            order: nil,
+            request_options: {}
+          )
+          end
+
+          # Deletes an organization spend alert.
+          sig do
+            params(
+              alert_id: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Admin::Organization::OrganizationSpendAlertDeleted
+            )
+          end
+          def delete(
+            # The ID of the spend alert to delete.
+            alert_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

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

@@ -314,6 +314,61 @@ module OpenAI
           )
           end
 
+          # Get file search calls usage details for the organization.
+          sig do
+            params(
+              start_time: Integer,
+              api_key_ids: T::Array[String],
+              bucket_width:
+                OpenAI::Admin::Organization::UsageFileSearchCallsParams::BucketWidth::OrSymbol,
+              end_time: Integer,
+              group_by:
+                T::Array[
+                  OpenAI::Admin::Organization::UsageFileSearchCallsParams::GroupBy::OrSymbol
+                ],
+              limit: Integer,
+              page: String,
+              project_ids: T::Array[String],
+              user_ids: T::Array[String],
+              vector_store_ids: T::Array[String],
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Models::Admin::Organization::UsageFileSearchCallsResponse
+            )
+          end
+          def file_search_calls(
+            # Start time (Unix seconds) of the query time range, inclusive.
+            start_time:,
+            # Return only usage for these API keys.
+            api_key_ids: nil,
+            # Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+            # supported, default to `1d`.
+            bucket_width: nil,
+            # End time (Unix seconds) of the query time range, exclusive.
+            end_time: nil,
+            # Group the usage data by the specified fields. Support fields include
+            # `project_id`, `user_id`, `api_key_id`, `vector_store_id` or any combination of
+            # them.
+            group_by: nil,
+            # Specifies the number of buckets to return.
+            #
+            # - `bucket_width=1d`: default: 7, max: 31
+            # - `bucket_width=1h`: default: 24, max: 168
+            # - `bucket_width=1m`: default: 60, max: 1440
+            limit: nil,
+            # A cursor for use in pagination. Corresponding to the `next_page` field from the
+            # previous response.
+            page: nil,
+            # Return only usage for these projects.
+            project_ids: nil,
+            # Return only usage for these users.
+            user_ids: nil,
+            # Return only usage for these vector stores.
+            vector_store_ids: nil,
+            request_options: {}
+          )
+          end
+
           # Get images usage details for the organization.
           sig do
             params(
@@ -480,6 +535,67 @@ module OpenAI
           )
           end
 
+          # Get web search calls usage details for the organization.
+          sig do
+            params(
+              start_time: Integer,
+              api_key_ids: T::Array[String],
+              bucket_width:
+                OpenAI::Admin::Organization::UsageWebSearchCallsParams::BucketWidth::OrSymbol,
+              context_levels:
+                T::Array[
+                  OpenAI::Admin::Organization::UsageWebSearchCallsParams::ContextLevel::OrSymbol
+                ],
+              end_time: Integer,
+              group_by:
+                T::Array[
+                  OpenAI::Admin::Organization::UsageWebSearchCallsParams::GroupBy::OrSymbol
+                ],
+              limit: Integer,
+              models: T::Array[String],
+              page: String,
+              project_ids: T::Array[String],
+              user_ids: T::Array[String],
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Models::Admin::Organization::UsageWebSearchCallsResponse
+            )
+          end
+          def web_search_calls(
+            # Start time (Unix seconds) of the query time range, inclusive.
+            start_time:,
+            # Return only usage for these API keys.
+            api_key_ids: nil,
+            # Width of each time bucket in response. Currently `1m`, `1h` and `1d` are
+            # supported, default to `1d`.
+            bucket_width: nil,
+            # Return only web search usage for these context levels.
+            context_levels: nil,
+            # End time (Unix seconds) of the query time range, exclusive.
+            end_time: nil,
+            # Group the usage data by the specified fields. Support fields include
+            # `project_id`, `user_id`, `api_key_id`, `model`, `context_level` or any
+            # combination of them.
+            group_by: nil,
+            # Specifies the number of buckets to return.
+            #
+            # - `bucket_width=1d`: default: 7, max: 31
+            # - `bucket_width=1h`: default: 24, max: 168
+            # - `bucket_width=1m`: default: 60, max: 1440
+            limit: nil,
+            # Return only usage for these models.
+            models: nil,
+            # A cursor for use in pagination. Corresponding to the `next_page` field from the
+            # previous response.
+            page: nil,
+            # Return only usage for these projects.
+            project_ids: nil,
+            # Return only usage for these users.
+            user_ids: nil,
+            request_options: {}
+          )
+          end
+
           # @api private
           sig { params(client: OpenAI::Client).returns(T.attached_class) }
           def self.new(client:)