openai 7.27.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.
@@ -366,7 +374,14 @@ export namespace UsageAudioSpeechesResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -760,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.
@@ -802,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.
@@ -825,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 {
@@ -911,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.
@@ -923,7 +968,14 @@ export namespace UsageAudioTranscriptionsResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -1317,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.
@@ -1359,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.
@@ -1382,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 {
@@ -1468,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.
@@ -1480,7 +1562,14 @@ export namespace UsageCodeInterpreterSessionsResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -1874,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.
@@ -1916,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.
@@ -1939,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 {
@@ -2025,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.
@@ -2037,7 +2156,14 @@ export namespace UsageCompletionsResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -2431,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.
@@ -2473,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.
@@ -2496,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 {
@@ -2582,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.
@@ -2594,7 +2750,14 @@ export namespace UsageCostsResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -2988,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.
@@ -3030,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.
@@ -3053,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 {
@@ -3139,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.
@@ -3151,7 +3344,14 @@ export namespace UsageEmbeddingsResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -3545,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.
@@ -3587,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.
@@ -3610,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 {
@@ -3696,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.
@@ -3708,7 +3938,14 @@ export namespace UsageFileSearchCallsResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -4102,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.
@@ -4144,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.
@@ -4167,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 {
@@ -4253,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.
@@ -4265,7 +4532,14 @@ export namespace UsageImagesResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -4659,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.
@@ -4701,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.
@@ -4724,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 {
@@ -4810,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.
@@ -4822,7 +5126,14 @@ export namespace UsageModerationsResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -5216,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.
@@ -5258,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.
@@ -5281,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 {
@@ -5367,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.
@@ -5379,7 +5720,14 @@ export namespace UsageVectorStoresResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -5773,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.
@@ -5815,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.
@@ -5838,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 {
@@ -5924,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.
@@ -5936,7 +6314,14 @@ export namespace UsageWebSearchCallsResponse {
       input_audio_tokens?: number;
 
       /**
-       * The aggregated number of input tokens written to the cache.
+       * The aggregated number of input tokens written to the cache with a 12-hour
+       * retention period.
+       */
+      input_cache_write_12h_tokens?: number;
+
+      /**
+       * The aggregated number of input tokens written to the cache with a 30-minute
+       * retention period.
        */
       input_cache_write_tokens?: number;
 
@@ -6330,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.
@@ -6372,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.
@@ -6395,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 {
@@ -6608,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.
@@ -6667,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
@@ -7019,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.