openai 0.98.0 → 0.100.0

data/lib/openai/models/admin/organization/usage_code_interpreter_sessions_response.rb

@@ -202,6 +202,21 @@ module OpenAI
                 #   @return [String, nil]
                 optional :api_key_id, String, nil?: true
 
+                # @!attribute api_source
+                #   When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #   activity and `unlabeled` includes all records without published source
+                #   attribution, including historical and unknown origins. Unlabeled does not imply
+                #   direct API usage. Without source grouping, this field is null.
+                #
+                #   @return [Symbol, OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource, nil]
+                optional(
+                  :api_source,
+                  enum: -> {
+                    OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource
+                  },
+                  nil?: true
+                )
+
                 # @!attribute batch
                 #   When `group_by=batch`, this field tells whether the grouped usage result is
                 #   batch or not.
@@ -215,8 +230,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -312,7 +335,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -332,6 +355,12 @@ module OpenAI
                 #     When `group_by=api_key_id`, this field provides the API key ID of the grouped
                 #     usage result.
                 #
+                #   @param api_source [Symbol, OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource, nil]
+                #     When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #     activity and `unlabeled` includes all records without published source
+                #     attribution, including historical and unknown origins. Unlabeled does not imply
+                #     direct API usage. Without source grouping, this field is null.
+                #
                 #   @param batch [Boolean, nil]
                 #     When `group_by=batch`, this field tells whether the grouped usage result is
                 #     batch or not.
@@ -339,8 +368,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.
@@ -392,6 +426,22 @@ module OpenAI
                 #     result.
                 #
                 #   @param object [Symbol, :"organization.usage.completions.result"]
+
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                #
+                # @see OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult#api_source
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API = :agents_api
+                  UNLABELED = :unlabeled
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
               end
 
               class OrganizationUsageEmbeddingsResult < OpenAI::Internal::Type::BaseModel
@@ -941,6 +991,21 @@ module OpenAI
                 #   @return [String, nil]
                 optional :api_key_id, String, nil?: true
 
+                # @!attribute api_source
+                #   When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #   activity and `unlabeled` includes all records without published source
+                #   attribution, including historical and unknown origins. Unlabeled does not imply
+                #   direct API usage. Without source grouping, this field is null.
+                #
+                #   @return [Symbol, OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource, nil]
+                optional(
+                  :api_source,
+                  enum: -> {
+                    OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource
+                  },
+                  nil?: true
+                )
+
                 # @!attribute context_level
                 #   When `group_by=context_level`, this field provides the search context size of
                 #   the grouped usage result.
@@ -969,7 +1034,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(num_model_requests:, num_requests:, api_key_id: nil, context_level: nil, model: nil, project_id: nil, user_id: nil, object: :"organization.usage.web_searches.result")
+                # @!method initialize(num_model_requests:, num_requests:, api_key_id: nil, api_source: nil, context_level: nil, model: nil, project_id: nil, user_id: nil, object: :"organization.usage.web_searches.result")
                 #   The aggregated web search calls usage details of the specific time bucket.
                 #
                 #   @param num_model_requests [Integer]
@@ -982,6 +1047,12 @@ module OpenAI
                 #     When `group_by=api_key_id`, this field provides the API key ID of the grouped
                 #     usage result.
                 #
+                #   @param api_source [Symbol, OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource, nil]
+                #     When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #     activity and `unlabeled` includes all records without published source
+                #     attribution, including historical and unknown origins. Unlabeled does not imply
+                #     direct API usage. Without source grouping, this field is null.
+                #
                 #   @param context_level [String, nil]
                 #     When `group_by=context_level`, this field provides the search context size of
                 #     the grouped usage result.
@@ -999,6 +1070,22 @@ module OpenAI
                 #     result.
                 #
                 #   @param object [Symbol, :"organization.usage.web_searches.result"]
+
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                #
+                # @see OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult#api_source
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API = :agents_api
+                  UNLABELED = :unlabeled
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
               end
 
               class OrganizationCostsResult < OpenAI::Internal::Type::BaseModel
@@ -1025,6 +1112,21 @@ module OpenAI
                 #   @return [String, nil]
                 optional :api_key_id, String, nil?: true
 
+                # @!attribute api_source
+                #   When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #   activity and `unlabeled` includes all records without published source
+                #   attribution, including historical and unknown origins. Unlabeled does not imply
+                #   direct API usage. Without source grouping, this field is null.
+                #
+                #   @return [Symbol, OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::APISource, nil]
+                optional(
+                  :api_source,
+                  enum: -> {
+                    OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::APISource
+                  },
+                  nil?: true
+                )
+
                 # @!attribute line_item
                 #   When `group_by=line_item`, this field provides the line item of the grouped
                 #   costs result.
@@ -1059,7 +1161,14 @@ module OpenAI
                   nil?: true
                 )
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, quantity_unit: nil, object: :"organization.costs.result")
+                # @!attribute user_id
+                #   When `group_by=user_id`, this field provides the user ID of the grouped costs
+                #   result.
+                #
+                #   @return [String, nil]
+                optional :user_id, String, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, api_source: nil, line_item: nil, project_id: nil, quantity: nil, quantity_unit: nil, user_id: nil, object: :"organization.costs.result")
                 #   The aggregated costs details of the specific time bucket.
                 #
                 #   @param amount [OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::Amount]
@@ -1069,6 +1178,12 @@ module OpenAI
                 #     When `group_by=api_key_id`, this field provides the API Key ID of the grouped
                 #     costs result.
                 #
+                #   @param api_source [Symbol, OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::APISource, nil]
+                #     When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #     activity and `unlabeled` includes all records without published source
+                #     attribution, including historical and unknown origins. Unlabeled does not imply
+                #     direct API usage. Without source grouping, this field is null.
+                #
                 #   @param line_item [String, nil]
                 #     When `group_by=line_item`, this field provides the line item of the grouped
                 #     costs result.
@@ -1085,6 +1200,10 @@ module OpenAI
                 #     The unit of the `quantity` value. If no single supported unit applies to the
                 #     result, this field is `null`.
                 #
+                #   @param user_id [String, nil]
+                #     When `group_by=user_id`, this field provides the user ID of the grouped costs
+                #     result.
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult#amount
@@ -1110,6 +1229,22 @@ module OpenAI
                   #   @param value [Float]
                   #     The numeric value of the cost.
                 end
+
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                #
+                # @see OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult#api_source
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API = :agents_api
+                  UNLABELED = :unlabeled
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
               end
 
               # @!method self.variants

data/lib/openai/models/admin/organization/usage_completions_params.rb

@@ -43,8 +43,10 @@ module OpenAI
 
           # @!attribute group_by
           #   Group the usage data by the specified fields. Support fields include
-          #   `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier` or any
-          #   combination of them.
+          #   `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier`,
+          #   `api_source` or any combination of them. When grouped by `api_source`, results
+          #   use `agents_api` for attributed Agents API activity and `unlabeled` for all
+          #   other activity. Without source grouping, `api_source` is null.
           #
           #   @return [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsParams::GroupBy>, nil]
           optional(
@@ -107,8 +109,10 @@ module OpenAI
           #
           #   @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsParams::GroupBy>]
           #     Group the usage data by the specified fields. Support fields include
-          #     `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier` or any
-          #     combination of them.
+          #     `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier`,
+          #     `api_source` or any combination of them. When grouped by `api_source`, results
+          #     use `agents_api` for attributed Agents API activity and `unlabeled` for all
+          #     other activity. Without source grouping, `api_source` is null.
           #
           #   @param limit [Integer]
           #     Specifies the number of buckets to return.
@@ -154,6 +158,7 @@ module OpenAI
             MODEL = :model
             BATCH = :batch
             SERVICE_TIER = :service_tier
+            API_SOURCE = :api_source
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/openai/models/admin/organization/usage_completions_response.rb

@@ -198,6 +198,21 @@ module OpenAI
                 #   @return [String, nil]
                 optional :api_key_id, String, nil?: true
 
+                # @!attribute api_source
+                #   When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #   activity and `unlabeled` includes all records without published source
+                #   attribution, including historical and unknown origins. Unlabeled does not imply
+                #   direct API usage. Without source grouping, this field is null.
+                #
+                #   @return [Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource, nil]
+                optional(
+                  :api_source,
+                  enum: -> {
+                    OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource
+                  },
+                  nil?: true
+                )
+
                 # @!attribute batch
                 #   When `group_by=batch`, this field tells whether the grouped usage result is
                 #   batch or not.
@@ -211,8 +226,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -308,7 +331,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -328,6 +351,12 @@ module OpenAI
                 #     When `group_by=api_key_id`, this field provides the API key ID of the grouped
                 #     usage result.
                 #
+                #   @param api_source [Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::APISource, nil]
+                #     When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #     activity and `unlabeled` includes all records without published source
+                #     attribution, including historical and unknown origins. Unlabeled does not imply
+                #     direct API usage. Without source grouping, this field is null.
+                #
                 #   @param batch [Boolean, nil]
                 #     When `group_by=batch`, this field tells whether the grouped usage result is
                 #     batch or not.
@@ -335,8 +364,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.
@@ -388,6 +422,22 @@ module OpenAI
                 #     result.
                 #
                 #   @param object [Symbol, :"organization.usage.completions.result"]
+
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                #
+                # @see OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult#api_source
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API = :agents_api
+                  UNLABELED = :unlabeled
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
               end
 
               class OrganizationUsageEmbeddingsResult < OpenAI::Internal::Type::BaseModel
@@ -937,6 +987,21 @@ module OpenAI
                 #   @return [String, nil]
                 optional :api_key_id, String, nil?: true
 
+                # @!attribute api_source
+                #   When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #   activity and `unlabeled` includes all records without published source
+                #   attribution, including historical and unknown origins. Unlabeled does not imply
+                #   direct API usage. Without source grouping, this field is null.
+                #
+                #   @return [Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource, nil]
+                optional(
+                  :api_source,
+                  enum: -> {
+                    OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource
+                  },
+                  nil?: true
+                )
+
                 # @!attribute context_level
                 #   When `group_by=context_level`, this field provides the search context size of
                 #   the grouped usage result.
@@ -965,7 +1030,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(num_model_requests:, num_requests:, api_key_id: nil, context_level: nil, model: nil, project_id: nil, user_id: nil, object: :"organization.usage.web_searches.result")
+                # @!method initialize(num_model_requests:, num_requests:, api_key_id: nil, api_source: nil, context_level: nil, model: nil, project_id: nil, user_id: nil, object: :"organization.usage.web_searches.result")
                 #   The aggregated web search calls usage details of the specific time bucket.
                 #
                 #   @param num_model_requests [Integer]
@@ -978,6 +1043,12 @@ module OpenAI
                 #     When `group_by=api_key_id`, this field provides the API key ID of the grouped
                 #     usage result.
                 #
+                #   @param api_source [Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource, nil]
+                #     When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #     activity and `unlabeled` includes all records without published source
+                #     attribution, including historical and unknown origins. Unlabeled does not imply
+                #     direct API usage. Without source grouping, this field is null.
+                #
                 #   @param context_level [String, nil]
                 #     When `group_by=context_level`, this field provides the search context size of
                 #     the grouped usage result.
@@ -995,6 +1066,22 @@ module OpenAI
                 #     result.
                 #
                 #   @param object [Symbol, :"organization.usage.web_searches.result"]
+
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                #
+                # @see OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult#api_source
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API = :agents_api
+                  UNLABELED = :unlabeled
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
               end
 
               class OrganizationCostsResult < OpenAI::Internal::Type::BaseModel
@@ -1021,6 +1108,21 @@ module OpenAI
                 #   @return [String, nil]
                 optional :api_key_id, String, nil?: true
 
+                # @!attribute api_source
+                #   When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #   activity and `unlabeled` includes all records without published source
+                #   attribution, including historical and unknown origins. Unlabeled does not imply
+                #   direct API usage. Without source grouping, this field is null.
+                #
+                #   @return [Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::APISource, nil]
+                optional(
+                  :api_source,
+                  enum: -> {
+                    OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::APISource
+                  },
+                  nil?: true
+                )
+
                 # @!attribute line_item
                 #   When `group_by=line_item`, this field provides the line item of the grouped
                 #   costs result.
@@ -1055,7 +1157,14 @@ module OpenAI
                   nil?: true
                 )
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, quantity_unit: nil, object: :"organization.costs.result")
+                # @!attribute user_id
+                #   When `group_by=user_id`, this field provides the user ID of the grouped costs
+                #   result.
+                #
+                #   @return [String, nil]
+                optional :user_id, String, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, api_source: nil, line_item: nil, project_id: nil, quantity: nil, quantity_unit: nil, user_id: nil, object: :"organization.costs.result")
                 #   The aggregated costs details of the specific time bucket.
                 #
                 #   @param amount [OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::Amount]
@@ -1065,6 +1174,12 @@ module OpenAI
                 #     When `group_by=api_key_id`, this field provides the API Key ID of the grouped
                 #     costs result.
                 #
+                #   @param api_source [Symbol, OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::APISource, nil]
+                #     When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                #     activity and `unlabeled` includes all records without published source
+                #     attribution, including historical and unknown origins. Unlabeled does not imply
+                #     direct API usage. Without source grouping, this field is null.
+                #
                 #   @param line_item [String, nil]
                 #     When `group_by=line_item`, this field provides the line item of the grouped
                 #     costs result.
@@ -1081,6 +1196,10 @@ module OpenAI
                 #     The unit of the `quantity` value. If no single supported unit applies to the
                 #     result, this field is `null`.
                 #
+                #   @param user_id [String, nil]
+                #     When `group_by=user_id`, this field provides the user ID of the grouped costs
+                #     result.
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult#amount
@@ -1106,6 +1225,22 @@ module OpenAI
                   #   @param value [Float]
                   #     The numeric value of the cost.
                 end
+
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                #
+                # @see OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult#api_source
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API = :agents_api
+                  UNLABELED = :unlabeled
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
               end
 
               # @!method self.variants

data/lib/openai/models/admin/organization/usage_costs_params.rb

@@ -35,8 +35,13 @@ module OpenAI
           optional :end_time, Integer
 
           # @!attribute group_by
-          #   Group the costs by the specified fields. Support fields include `project_id`,
-          #   `line_item`, `api_key_id` and any combination of them.
+          #   Group the costs by the specified fields. Supported fields include `project_id`,
+          #   `user_id`, `line_item`, `api_key_id`, and `api_source`. Support for combining
+          #   `user_id` with `project_id` grouping or the `project_ids` filter depends on the
+          #   organization and requested time range. Unsupported combinations return HTTP 400.
+          #   When grouped by `api_source`, results use `agents_api` for attributed Agents API
+          #   activity and `unlabeled` for all other activity. Without source grouping,
+          #   `api_source` is null.
           #
           #   @return [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCostsParams::GroupBy>, nil]
           optional(
@@ -86,8 +91,13 @@ module OpenAI
           #     End time (Unix seconds) of the query time range, exclusive.
           #
           #   @param group_by [Array<Symbol, OpenAI::Models::Admin::Organization::UsageCostsParams::GroupBy>]
-          #     Group the costs by the specified fields. Support fields include `project_id`,
-          #     `line_item`, `api_key_id` and any combination of them.
+          #     Group the costs by the specified fields. Supported fields include `project_id`,
+          #     `user_id`, `line_item`, `api_key_id`, and `api_source`. Support for combining
+          #     `user_id` with `project_id` grouping or the `project_ids` filter depends on the
+          #     organization and requested time range. Unsupported combinations return HTTP 400.
+          #     When grouped by `api_source`, results use `agents_api` for attributed Agents API
+          #     activity and `unlabeled` for all other activity. Without source grouping,
+          #     `api_source` is null.
           #
           #   @param limit [Integer]
           #     A limit on the number of buckets to be returned. Limit can range between 1 and
@@ -121,8 +131,10 @@ module OpenAI
             extend OpenAI::Internal::Type::Enum
 
             PROJECT_ID = :project_id
+            USER_ID = :user_id
             LINE_ITEM = :line_item
             API_KEY_ID = :api_key_id
+            API_SOURCE = :api_source
 
             # @!method self.values
             #   @return [Array<Symbol>]