openai 0.63.0 → 0.65.0

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:)

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

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

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

@@ -26,6 +26,12 @@ module OpenAI
         sig { returns(OpenAI::Resources::Admin::Organization::Roles) }
         attr_reader :roles
 
+        sig { returns(OpenAI::Resources::Admin::Organization::DataRetention) }
+        attr_reader :data_retention
+
+        sig { returns(OpenAI::Resources::Admin::Organization::SpendAlerts) }
+        attr_reader :spend_alerts
+
         sig { returns(OpenAI::Resources::Admin::Organization::Certificates) }
         attr_reader :certificates
 

data/rbi/openai/resources/chat/completions.rbi

@@ -232,6 +232,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,
           # Constrains effort on reasoning for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
@@ -571,6 +579,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,
           # Constrains effort on reasoning for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently

data/rbi/openai/resources/conversations/items.rbi

@@ -23,6 +23,7 @@ module OpenAI
                   OpenAI::Responses::ResponseInputItem::FunctionCallOutput::OrHash,
                   OpenAI::Responses::ResponseInputItem::ToolSearchCall::OrHash,
                   OpenAI::Responses::ResponseToolSearchOutputItemParam::OrHash,
+                  OpenAI::Responses::ResponseInputItem::AdditionalTools::OrHash,
                   OpenAI::Responses::ResponseReasoningItem::OrHash,
                   OpenAI::Responses::ResponseCompactionItemParam::OrHash,
                   OpenAI::Responses::ResponseInputItem::ImageGenerationCall::OrHash,
@@ -39,6 +40,7 @@ module OpenAI
                   OpenAI::Responses::ResponseInputItem::McpCall::OrHash,
                   OpenAI::Responses::ResponseCustomToolCallOutput::OrHash,
                   OpenAI::Responses::ResponseCustomToolCall::OrHash,
+                  OpenAI::Responses::ResponseInputItem::CompactionTrigger::OrHash,
                   OpenAI::Responses::ResponseInputItem::ItemReference::OrHash
                 )
               ],

data/rbi/openai/resources/conversations.rbi

@@ -26,6 +26,7 @@ module OpenAI
                   OpenAI::Responses::ResponseInputItem::FunctionCallOutput::OrHash,
                   OpenAI::Responses::ResponseInputItem::ToolSearchCall::OrHash,
                   OpenAI::Responses::ResponseToolSearchOutputItemParam::OrHash,
+                  OpenAI::Responses::ResponseInputItem::AdditionalTools::OrHash,
                   OpenAI::Responses::ResponseReasoningItem::OrHash,
                   OpenAI::Responses::ResponseCompactionItemParam::OrHash,
                   OpenAI::Responses::ResponseInputItem::ImageGenerationCall::OrHash,
@@ -42,6 +43,7 @@ module OpenAI
                   OpenAI::Responses::ResponseInputItem::McpCall::OrHash,
                   OpenAI::Responses::ResponseCustomToolCallOutput::OrHash,
                   OpenAI::Responses::ResponseCustomToolCall::OrHash,
+                  OpenAI::Responses::ResponseInputItem::CompactionTrigger::OrHash,
                   OpenAI::Responses::ResponseInputItem::ItemReference::OrHash
                 )
               ]

data/rbi/openai/resources/responses/input_tokens.rbi

@@ -24,6 +24,11 @@ module OpenAI
             instructions: T.nilable(String),
             model: T.nilable(String),
             parallel_tool_calls: T.nilable(T::Boolean),
+            personality:
+              T.any(
+                String,
+                OpenAI::Responses::InputTokenCountParams::Personality::OrSymbol
+              ),
             previous_response_id: T.nilable(String),
             reasoning: T.nilable(OpenAI::Reasoning::OrHash),
             text:
@@ -89,6 +94,10 @@ module OpenAI
           model: nil,
           # Whether to allow the model to run tool calls in parallel.
           parallel_tool_calls: nil,
+          # A model-owned style preset to apply to this request. Omit this parameter to use
+          # the model's default style. Supported values may expand over time. Values must be
+          # at most 64 characters.
+          personality: nil,
           # The unique ID of the previous response to the model. Use this to create
           # multi-turn conversations. Learn more about
           # [conversation state](https://platform.openai.com/docs/guides/conversation-state).

data/rbi/openai/resources/responses.rbi

@@ -206,6 +206,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**
         #
@@ -509,6 +517,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**
         #

data/sig/openai/models/admin/organization/audit_log_list_params.rbs

@@ -160,6 +160,12 @@ module OpenAI
             | :"tunnel.created"
             | :"tunnel.updated"
             | :"tunnel.deleted"
+            | :"workload_identity_provider.created"
+            | :"workload_identity_provider.updated"
+            | :"workload_identity_provider.deleted"
+            | :"workload_identity_provider_mapping.created"
+            | :"workload_identity_provider_mapping.updated"
+            | :"workload_identity_provider_mapping.deleted"
             | :"role.created"
             | :"role.updated"
             | :"role.deleted"
@@ -215,6 +221,12 @@ module OpenAI
             TUNNEL_CREATED: :"tunnel.created"
             TUNNEL_UPDATED: :"tunnel.updated"
             TUNNEL_DELETED: :"tunnel.deleted"
+            WORKLOAD_IDENTITY_PROVIDER_CREATED: :"workload_identity_provider.created"
+            WORKLOAD_IDENTITY_PROVIDER_UPDATED: :"workload_identity_provider.updated"
+            WORKLOAD_IDENTITY_PROVIDER_DELETED: :"workload_identity_provider.deleted"
+            WORKLOAD_IDENTITY_PROVIDER_MAPPING_CREATED: :"workload_identity_provider_mapping.created"
+            WORKLOAD_IDENTITY_PROVIDER_MAPPING_UPDATED: :"workload_identity_provider_mapping.updated"
+            WORKLOAD_IDENTITY_PROVIDER_MAPPING_DELETED: :"workload_identity_provider_mapping.deleted"
             ROLE_CREATED: :"role.created"
             ROLE_UPDATED: :"role.updated"
             ROLE_DELETED: :"role.deleted"