openai 7.28.0 → 7.30.0

package/src/resources/admin/organization/usage.ts

@@ -354,6 +354,14 @@ export namespace UsageAudioSpeechesResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -767,6 +775,14 @@ export namespace UsageAudioSpeechesResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -809,6 +825,14 @@ export namespace UsageAudioSpeechesResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -832,6 +856,12 @@ export namespace UsageAudioSpeechesResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -918,6 +948,14 @@ export namespace UsageAudioTranscriptionsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -1331,6 +1369,14 @@ export namespace UsageAudioTranscriptionsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -1373,6 +1419,14 @@ export namespace UsageAudioTranscriptionsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -1396,6 +1450,12 @@ export namespace UsageAudioTranscriptionsResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -1482,6 +1542,14 @@ export namespace UsageCodeInterpreterSessionsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -1895,6 +1963,14 @@ export namespace UsageCodeInterpreterSessionsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -1937,6 +2013,14 @@ export namespace UsageCodeInterpreterSessionsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -1960,6 +2044,12 @@ export namespace UsageCodeInterpreterSessionsResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -2046,6 +2136,14 @@ export namespace UsageCompletionsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -2459,6 +2557,14 @@ export namespace UsageCompletionsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -2501,6 +2607,14 @@ export namespace UsageCompletionsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -2524,6 +2638,12 @@ export namespace UsageCompletionsResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -2610,6 +2730,14 @@ export namespace UsageCostsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -3023,6 +3151,14 @@ export namespace UsageCostsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -3065,6 +3201,14 @@ export namespace UsageCostsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -3088,6 +3232,12 @@ export namespace UsageCostsResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -3174,6 +3324,14 @@ export namespace UsageEmbeddingsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -3587,6 +3745,14 @@ export namespace UsageEmbeddingsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -3629,6 +3795,14 @@ export namespace UsageEmbeddingsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -3652,6 +3826,12 @@ export namespace UsageEmbeddingsResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -3738,6 +3918,14 @@ export namespace UsageFileSearchCallsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -4151,6 +4339,14 @@ export namespace UsageFileSearchCallsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -4193,6 +4389,14 @@ export namespace UsageFileSearchCallsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -4216,6 +4420,12 @@ export namespace UsageFileSearchCallsResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -4302,6 +4512,14 @@ export namespace UsageImagesResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -4715,6 +4933,14 @@ export namespace UsageImagesResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -4757,6 +4983,14 @@ export namespace UsageImagesResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -4780,6 +5014,12 @@ export namespace UsageImagesResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -4866,6 +5106,14 @@ export namespace UsageModerationsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -5279,6 +5527,14 @@ export namespace UsageModerationsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -5321,6 +5577,14 @@ export namespace UsageModerationsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -5344,6 +5608,12 @@ export namespace UsageModerationsResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -5430,6 +5700,14 @@ export namespace UsageVectorStoresResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -5843,6 +6121,14 @@ export namespace UsageVectorStoresResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -5885,6 +6171,14 @@ export namespace UsageVectorStoresResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -5908,6 +6202,12 @@ export namespace UsageVectorStoresResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -5994,6 +6294,14 @@ export namespace UsageWebSearchCallsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=batch`, this field tells whether the grouped usage result is
        * batch or not.
@@ -6407,6 +6715,14 @@ export namespace UsageWebSearchCallsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=context_level`, this field provides the search context size of
        * the grouped usage result.
@@ -6449,6 +6765,14 @@ export namespace UsageWebSearchCallsResponse {
        */
       api_key_id?: string | null;
 
+      /**
+       * 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.
+       */
+      api_source?: 'agents_api' | 'unlabeled' | null;
+
       /**
        * When `group_by=line_item`, this field provides the line item of the grouped
        * costs result.
@@ -6472,6 +6796,12 @@ export namespace UsageWebSearchCallsResponse {
        * result, this field is `null`.
        */
       quantity_unit?: UsageAPI.CostQuantityUnit | null;
+
+      /**
+       * When `group_by=user_id`, this field provides the user ID of the grouped costs
+       * result.
+       */
+      user_id?: string | null;
     }
 
     export namespace OrganizationCostsResult {
@@ -6685,10 +7015,14 @@ export interface UsageCompletionsParams {
 
   /**
    * 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.
    */
-  group_by?: Array<'project_id' | 'user_id' | 'api_key_id' | 'model' | 'batch' | 'service_tier'>;
+  group_by?: Array<
+    'project_id' | 'user_id' | 'api_key_id' | 'model' | 'batch' | 'service_tier' | 'api_source'
+  >;
 
   /**
    * Specifies the number of buckets to return.
@@ -6744,10 +7078,15 @@ export interface UsageCostsParams {
   end_time?: number;
 
   /**
-   * 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.
    */
-  group_by?: Array<'project_id' | 'line_item' | 'api_key_id'>;
+  group_by?: Array<'project_id' | 'user_id' | 'line_item' | 'api_key_id' | 'api_source'>;
 
   /**
    * A limit on the number of buckets to be returned. Limit can range between 1 and
@@ -7096,10 +7435,12 @@ export interface UsageWebSearchCallsParams {
 
   /**
    * 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.
+   * `project_id`, `user_id`, `api_key_id`, `model`, `context_level`, `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.
    */
-  group_by?: Array<'project_id' | 'user_id' | 'api_key_id' | 'model' | 'context_level'>;
+  group_by?: Array<'project_id' | 'user_id' | 'api_key_id' | 'model' | 'context_level' | 'api_source'>;
 
   /**
    * Specifies the number of buckets to return.