openai 7.28.0 → 7.30.0

package/resources/admin/organization/usage.d.mts

@@ -181,6 +181,13 @@ export declare namespace UsageAudioSpeechesResponse {
              * usage result.
              */
             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.
@@ -523,6 +530,13 @@ export declare namespace UsageAudioSpeechesResponse {
              * usage result.
              */
             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.
@@ -558,6 +572,13 @@ export declare namespace UsageAudioSpeechesResponse {
              * costs result.
              */
             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.
@@ -578,6 +599,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -636,6 +662,13 @@ export declare namespace UsageAudioTranscriptionsResponse {
              * usage result.
              */
             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.
@@ -978,6 +1011,13 @@ export declare namespace UsageAudioTranscriptionsResponse {
              * usage result.
              */
             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.
@@ -1013,6 +1053,13 @@ export declare namespace UsageAudioTranscriptionsResponse {
              * costs result.
              */
             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.
@@ -1033,6 +1080,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -1091,6 +1143,13 @@ export declare namespace UsageCodeInterpreterSessionsResponse {
              * usage result.
              */
             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.
@@ -1433,6 +1492,13 @@ export declare namespace UsageCodeInterpreterSessionsResponse {
              * usage result.
              */
             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.
@@ -1468,6 +1534,13 @@ export declare namespace UsageCodeInterpreterSessionsResponse {
              * costs result.
              */
             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.
@@ -1488,6 +1561,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -1546,6 +1624,13 @@ export declare namespace UsageCompletionsResponse {
              * usage result.
              */
             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.
@@ -1888,6 +1973,13 @@ export declare namespace UsageCompletionsResponse {
              * usage result.
              */
             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.
@@ -1923,6 +2015,13 @@ export declare namespace UsageCompletionsResponse {
              * costs result.
              */
             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.
@@ -1943,6 +2042,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -2001,6 +2105,13 @@ export declare namespace UsageCostsResponse {
              * usage result.
              */
             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.
@@ -2343,6 +2454,13 @@ export declare namespace UsageCostsResponse {
              * usage result.
              */
             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.
@@ -2378,6 +2496,13 @@ export declare namespace UsageCostsResponse {
              * costs result.
              */
             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.
@@ -2398,6 +2523,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -2456,6 +2586,13 @@ export declare namespace UsageEmbeddingsResponse {
              * usage result.
              */
             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.
@@ -2798,6 +2935,13 @@ export declare namespace UsageEmbeddingsResponse {
              * usage result.
              */
             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.
@@ -2833,6 +2977,13 @@ export declare namespace UsageEmbeddingsResponse {
              * costs result.
              */
             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.
@@ -2853,6 +3004,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -2911,6 +3067,13 @@ export declare namespace UsageFileSearchCallsResponse {
              * usage result.
              */
             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.
@@ -3253,6 +3416,13 @@ export declare namespace UsageFileSearchCallsResponse {
              * usage result.
              */
             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.
@@ -3288,6 +3458,13 @@ export declare namespace UsageFileSearchCallsResponse {
              * costs result.
              */
             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.
@@ -3308,6 +3485,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -3366,6 +3548,13 @@ export declare namespace UsageImagesResponse {
              * usage result.
              */
             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.
@@ -3708,6 +3897,13 @@ export declare namespace UsageImagesResponse {
              * usage result.
              */
             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.
@@ -3743,6 +3939,13 @@ export declare namespace UsageImagesResponse {
              * costs result.
              */
             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.
@@ -3763,6 +3966,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -3821,6 +4029,13 @@ export declare namespace UsageModerationsResponse {
              * usage result.
              */
             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.
@@ -4163,6 +4378,13 @@ export declare namespace UsageModerationsResponse {
              * usage result.
              */
             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.
@@ -4198,6 +4420,13 @@ export declare namespace UsageModerationsResponse {
              * costs result.
              */
             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.
@@ -4218,6 +4447,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -4276,6 +4510,13 @@ export declare namespace UsageVectorStoresResponse {
              * usage result.
              */
             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.
@@ -4618,6 +4859,13 @@ export declare namespace UsageVectorStoresResponse {
              * usage result.
              */
             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.
@@ -4653,6 +4901,13 @@ export declare namespace UsageVectorStoresResponse {
              * costs result.
              */
             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.
@@ -4673,6 +4928,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -4731,6 +4991,13 @@ export declare namespace UsageWebSearchCallsResponse {
              * usage result.
              */
             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.
@@ -5073,6 +5340,13 @@ export declare namespace UsageWebSearchCallsResponse {
              * usage result.
              */
             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.
@@ -5108,6 +5382,13 @@ export declare namespace UsageWebSearchCallsResponse {
              * costs result.
              */
             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.
@@ -5128,6 +5409,11 @@ export declare 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;
         }
         namespace OrganizationCostsResult {
             /**
@@ -5306,10 +5592,12 @@ export interface UsageCompletionsParams {
     end_time?: number;
     /**
      * 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.
      *
@@ -5355,10 +5643,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
      * 180, and the default is 7.
@@ -5648,10 +5941,12 @@ export interface UsageWebSearchCallsParams {
     end_time?: number;
     /**
      * 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.
      *