openai 0.99.0 → 0.101.0

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

@@ -87,6 +87,7 @@ module OpenAI
                   ?object: :"organization.usage.completions.result",
                   output_tokens: Integer,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::api_source?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
                   ?:input_cache_write_12h_tokens => Integer,
@@ -127,6 +128,12 @@ module OpenAI
                 # usage result.
                 attr_accessor api_key_id: String?
 
+                # 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.
+                attr_accessor api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::api_source?
+
                 # When `group_by=batch`, this field tells whether the grouped usage result is
                 # batch or not.
                 attr_accessor batch: bool?
@@ -248,6 +255,11 @@ module OpenAI
                 # @param api_key_id
                 #   When `group_by=api_key_id`, this field provides the API key ID of the grouped
                 #   usage result.
+                # @param 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.
                 # @param batch
                 #   When `group_by=batch`, this field tells whether the grouped usage result is
                 #   batch or not.
@@ -299,6 +311,7 @@ module OpenAI
                   num_model_requests: Integer,
                   output_tokens: Integer,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::api_source?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
                   ?input_cache_write_12h_tokens: Integer,
@@ -326,6 +339,7 @@ module OpenAI
                   ?object: :"organization.usage.completions.result",
                   output_tokens: Integer,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::api_source?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
                   ?:input_cache_write_12h_tokens => Integer,
@@ -345,6 +359,17 @@ module OpenAI
                   ?service_tier: String?,
                   ?user_id: String?
                 }
+
+                type api_source = :agents_api | :unlabeled
+
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API: :agents_api
+                  UNLABELED: :unlabeled
+
+                  def self?.values: -> ::Array[OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageCompletionsResult::api_source]
+                end
               end
 
               type organization_usage_embeddings_result =
@@ -873,6 +898,7 @@ module OpenAI
                   num_requests: Integer,
                   ?object: :"organization.usage.web_searches.result",
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::api_source?,
                   ?context_level: String?,
                   ?model: String?,
                   ?project_id: String?,
@@ -892,6 +918,12 @@ module OpenAI
                 # usage result.
                 attr_accessor api_key_id: String?
 
+                # 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.
+                attr_accessor api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::api_source?
+
                 # When `group_by=context_level`, this field provides the search context size of
                 # the grouped usage result.
                 attr_accessor context_level: String?
@@ -915,6 +947,11 @@ module OpenAI
                 # @param api_key_id
                 #   When `group_by=api_key_id`, this field provides the API key ID of the grouped
                 #   usage result.
+                # @param 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.
                 # @param context_level
                 #   When `group_by=context_level`, this field provides the search context size of
                 #   the grouped usage result.
@@ -931,6 +968,7 @@ module OpenAI
                   num_model_requests: Integer,
                   num_requests: Integer,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::api_source?,
                   ?context_level: String?,
                   ?model: String?,
                   ?project_id: String?,
@@ -943,11 +981,23 @@ module OpenAI
                   num_requests: Integer,
                   ?object: :"organization.usage.web_searches.result",
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::api_source?,
                   ?context_level: String?,
                   ?model: String?,
                   ?project_id: String?,
                   ?user_id: String?
                 }
+
+                type api_source = :agents_api | :unlabeled
+
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API: :agents_api
+                  UNLABELED: :unlabeled
+
+                  def self?.values: -> ::Array[OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationUsageWebSearchesResult::api_source]
+                end
               end
 
               type organization_costs_result =
@@ -955,10 +1005,12 @@ module OpenAI
                   ?object: :"organization.costs.result",
                   ?amount: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::Amount,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::api_source?,
                   ?line_item: String?,
                   ?project_id: String?,
                   ?quantity: Float?,
-                  ?quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?
+                  ?quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?,
+                  ?user_id: String?
                 }
 
               class OrganizationCostsResult < OpenAI::Internal::Type::BaseModel
@@ -976,6 +1028,12 @@ module OpenAI
                 # costs result.
                 attr_accessor api_key_id: String?
 
+                # 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.
+                attr_accessor api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::api_source?
+
                 # When `group_by=line_item`, this field provides the line item of the grouped
                 # costs result.
                 attr_accessor line_item: String?
@@ -992,11 +1050,20 @@ module OpenAI
                 # result, this field is `null`.
                 attr_accessor quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?
 
+                # When `group_by=user_id`, this field provides the user ID of the grouped costs
+                # result.
+                attr_accessor user_id: String?
+
                 # @param amount
                 #   The monetary value in its associated currency.
                 # @param api_key_id
                 #   When `group_by=api_key_id`, this field provides the API Key ID of the grouped
                 #   costs result.
+                # @param 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.
                 # @param line_item
                 #   When `group_by=line_item`, this field provides the line item of the grouped
                 #   costs result.
@@ -1009,13 +1076,18 @@ module OpenAI
                 # @param quantity_unit
                 #   The unit of the `quantity` value. If no single supported unit applies to the
                 #   result, this field is `null`.
+                # @param user_id
+                #   When `group_by=user_id`, this field provides the user ID of the grouped costs
+                #   result.
                 def initialize: (
                   ?amount: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::Amount,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::api_source?,
                   ?line_item: String?,
                   ?project_id: String?,
                   ?quantity: Float?,
                   ?quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?,
+                  ?user_id: String?,
                   ?object: :"organization.costs.result"
                 ) -> void
 
@@ -1023,10 +1095,12 @@ module OpenAI
                   ?object: :"organization.costs.result",
                   ?amount: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::Amount,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::api_source?,
                   ?line_item: String?,
                   ?project_id: String?,
                   ?quantity: Float?,
-                  ?quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?
+                  ?quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?,
+                  ?user_id: String?
                 }
 
                 type amount = { ?currency: String, ?value: Float }
@@ -1052,6 +1126,17 @@ module OpenAI
 
                   def to_hash: -> { ?currency: String, ?value: Float }
                 end
+
+                type api_source = :agents_api | :unlabeled
+
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API: :agents_api
+                  UNLABELED: :unlabeled
+
+                  def self?.values: -> ::Array[OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult::api_source]
+                end
               end
 
               def self?.variants: -> ::Array[OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::result]

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

@@ -56,13 +56,17 @@ module OpenAI
           def end_time=: (Integer) -> Integer
 
           # 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.
           attr_reader group_by: ::Array[OpenAI::Models::Admin::Organization::UsageCompletionsParams::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.
           def group_by=: (
             ::Array[OpenAI::Models::Admin::Organization::UsageCompletionsParams::group_by]
           ) -> ::Array[OpenAI::Models::Admin::Organization::UsageCompletionsParams::group_by]
@@ -121,8 +125,10 @@ module OpenAI
           #   End time (Unix seconds) of the query time range, exclusive.
           # @param 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.
           # @param limit
           #   Specifies the number of buckets to return.
           #
@@ -187,6 +193,7 @@ module OpenAI
             | :model
             | :batch
             | :service_tier
+            | :api_source
 
           module GroupBy
             extend OpenAI::Internal::Type::Enum
@@ -197,6 +204,7 @@ module OpenAI
             MODEL: :model
             BATCH: :batch
             SERVICE_TIER: :service_tier
+            API_SOURCE: :api_source
 
             def self?.values: -> ::Array[OpenAI::Models::Admin::Organization::UsageCompletionsParams::group_by]
           end

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

@@ -87,6 +87,7 @@ module OpenAI
                   ?object: :"organization.usage.completions.result",
                   output_tokens: Integer,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::api_source?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
                   ?:input_cache_write_12h_tokens => Integer,
@@ -127,6 +128,12 @@ module OpenAI
                 # usage result.
                 attr_accessor api_key_id: String?
 
+                # 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.
+                attr_accessor api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::api_source?
+
                 # When `group_by=batch`, this field tells whether the grouped usage result is
                 # batch or not.
                 attr_accessor batch: bool?
@@ -248,6 +255,11 @@ module OpenAI
                 # @param api_key_id
                 #   When `group_by=api_key_id`, this field provides the API key ID of the grouped
                 #   usage result.
+                # @param 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.
                 # @param batch
                 #   When `group_by=batch`, this field tells whether the grouped usage result is
                 #   batch or not.
@@ -299,6 +311,7 @@ module OpenAI
                   num_model_requests: Integer,
                   output_tokens: Integer,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::api_source?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
                   ?input_cache_write_12h_tokens: Integer,
@@ -326,6 +339,7 @@ module OpenAI
                   ?object: :"organization.usage.completions.result",
                   output_tokens: Integer,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::api_source?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
                   ?:input_cache_write_12h_tokens => Integer,
@@ -345,6 +359,17 @@ module OpenAI
                   ?service_tier: String?,
                   ?user_id: String?
                 }
+
+                type api_source = :agents_api | :unlabeled
+
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API: :agents_api
+                  UNLABELED: :unlabeled
+
+                  def self?.values: -> ::Array[OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageCompletionsResult::api_source]
+                end
               end
 
               type organization_usage_embeddings_result =
@@ -873,6 +898,7 @@ module OpenAI
                   num_requests: Integer,
                   ?object: :"organization.usage.web_searches.result",
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::api_source?,
                   ?context_level: String?,
                   ?model: String?,
                   ?project_id: String?,
@@ -892,6 +918,12 @@ module OpenAI
                 # usage result.
                 attr_accessor api_key_id: String?
 
+                # 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.
+                attr_accessor api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::api_source?
+
                 # When `group_by=context_level`, this field provides the search context size of
                 # the grouped usage result.
                 attr_accessor context_level: String?
@@ -915,6 +947,11 @@ module OpenAI
                 # @param api_key_id
                 #   When `group_by=api_key_id`, this field provides the API key ID of the grouped
                 #   usage result.
+                # @param 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.
                 # @param context_level
                 #   When `group_by=context_level`, this field provides the search context size of
                 #   the grouped usage result.
@@ -931,6 +968,7 @@ module OpenAI
                   num_model_requests: Integer,
                   num_requests: Integer,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::api_source?,
                   ?context_level: String?,
                   ?model: String?,
                   ?project_id: String?,
@@ -943,11 +981,23 @@ module OpenAI
                   num_requests: Integer,
                   ?object: :"organization.usage.web_searches.result",
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::api_source?,
                   ?context_level: String?,
                   ?model: String?,
                   ?project_id: String?,
                   ?user_id: String?
                 }
+
+                type api_source = :agents_api | :unlabeled
+
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API: :agents_api
+                  UNLABELED: :unlabeled
+
+                  def self?.values: -> ::Array[OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationUsageWebSearchesResult::api_source]
+                end
               end
 
               type organization_costs_result =
@@ -955,10 +1005,12 @@ module OpenAI
                   ?object: :"organization.costs.result",
                   ?amount: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::Amount,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::api_source?,
                   ?line_item: String?,
                   ?project_id: String?,
                   ?quantity: Float?,
-                  ?quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?
+                  ?quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?,
+                  ?user_id: String?
                 }
 
               class OrganizationCostsResult < OpenAI::Internal::Type::BaseModel
@@ -976,6 +1028,12 @@ module OpenAI
                 # costs result.
                 attr_accessor api_key_id: String?
 
+                # 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.
+                attr_accessor api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::api_source?
+
                 # When `group_by=line_item`, this field provides the line item of the grouped
                 # costs result.
                 attr_accessor line_item: String?
@@ -992,11 +1050,20 @@ module OpenAI
                 # result, this field is `null`.
                 attr_accessor quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?
 
+                # When `group_by=user_id`, this field provides the user ID of the grouped costs
+                # result.
+                attr_accessor user_id: String?
+
                 # @param amount
                 #   The monetary value in its associated currency.
                 # @param api_key_id
                 #   When `group_by=api_key_id`, this field provides the API Key ID of the grouped
                 #   costs result.
+                # @param 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.
                 # @param line_item
                 #   When `group_by=line_item`, this field provides the line item of the grouped
                 #   costs result.
@@ -1009,13 +1076,18 @@ module OpenAI
                 # @param quantity_unit
                 #   The unit of the `quantity` value. If no single supported unit applies to the
                 #   result, this field is `null`.
+                # @param user_id
+                #   When `group_by=user_id`, this field provides the user ID of the grouped costs
+                #   result.
                 def initialize: (
                   ?amount: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::Amount,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::api_source?,
                   ?line_item: String?,
                   ?project_id: String?,
                   ?quantity: Float?,
                   ?quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?,
+                  ?user_id: String?,
                   ?object: :"organization.costs.result"
                 ) -> void
 
@@ -1023,10 +1095,12 @@ module OpenAI
                   ?object: :"organization.costs.result",
                   ?amount: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::Amount,
                   ?api_key_id: String?,
+                  ?api_source: OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::api_source?,
                   ?line_item: String?,
                   ?project_id: String?,
                   ?quantity: Float?,
-                  ?quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?
+                  ?quantity_unit: OpenAI::Models::Admin::Organization::cost_quantity_unit?,
+                  ?user_id: String?
                 }
 
                 type amount = { ?currency: String, ?value: Float }
@@ -1052,6 +1126,17 @@ module OpenAI
 
                   def to_hash: -> { ?currency: String, ?value: Float }
                 end
+
+                type api_source = :agents_api | :unlabeled
+
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  AGENTS_API: :agents_api
+                  UNLABELED: :unlabeled
+
+                  def self?.values: -> ::Array[OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult::api_source]
+                end
               end
 
               def self?.variants: -> ::Array[OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::result]

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

@@ -45,12 +45,22 @@ module OpenAI
           # End time (Unix seconds) of the query time range, exclusive.
           def end_time=: (Integer) -> Integer
 
-          # 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.
           attr_reader group_by: ::Array[OpenAI::Models::Admin::Organization::UsageCostsParams::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.
           def group_by=: (
             ::Array[OpenAI::Models::Admin::Organization::UsageCostsParams::group_by]
           ) -> ::Array[OpenAI::Models::Admin::Organization::UsageCostsParams::group_by]
@@ -95,8 +105,13 @@ module OpenAI
           # @param end_time
           #   End time (Unix seconds) of the query time range, exclusive.
           # @param 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.
           # @param limit
           #   A limit on the number of buckets to be returned. Limit can range between 1 and
           #   180, and the default is 7.
@@ -144,14 +159,17 @@ module OpenAI
             def self?.values: -> ::Array[OpenAI::Models::Admin::Organization::UsageCostsParams::bucket_width]
           end
 
-          type group_by = :project_id | :line_item | :api_key_id
+          type group_by =
+            :project_id | :user_id | :line_item | :api_key_id | :api_source
 
           module GroupBy
             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
 
             def self?.values: -> ::Array[OpenAI::Models::Admin::Organization::UsageCostsParams::group_by]
           end