openai 7.27.0 → 7.30.0

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

@@ -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.
@@ -191,7 +198,13 @@ export declare 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;
             /**
@@ -517,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.
@@ -552,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.
@@ -572,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 {
             /**
@@ -630,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.
@@ -640,7 +679,13 @@ export declare 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;
             /**
@@ -966,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.
@@ -1001,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.
@@ -1021,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 {
             /**
@@ -1079,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.
@@ -1089,7 +1160,13 @@ export declare 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;
             /**
@@ -1415,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.
@@ -1450,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.
@@ -1470,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 {
             /**
@@ -1528,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.
@@ -1538,7 +1641,13 @@ export declare 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;
             /**
@@ -1864,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.
@@ -1899,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.
@@ -1919,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 {
             /**
@@ -1977,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.
@@ -1987,7 +2122,13 @@ export declare 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;
             /**
@@ -2313,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.
@@ -2348,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.
@@ -2368,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 {
             /**
@@ -2426,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.
@@ -2436,7 +2603,13 @@ export declare 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;
             /**
@@ -2762,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.
@@ -2797,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.
@@ -2817,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 {
             /**
@@ -2875,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.
@@ -2885,7 +3084,13 @@ export declare 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;
             /**
@@ -3211,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.
@@ -3246,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.
@@ -3266,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 {
             /**
@@ -3324,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.
@@ -3334,7 +3565,13 @@ export declare 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;
             /**
@@ -3660,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.
@@ -3695,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.
@@ -3715,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 {
             /**
@@ -3773,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.
@@ -3783,7 +4046,13 @@ export declare 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;
             /**
@@ -4109,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.
@@ -4144,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.
@@ -4164,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 {
             /**
@@ -4222,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.
@@ -4232,7 +4527,13 @@ export declare 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;
             /**
@@ -4558,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.
@@ -4593,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.
@@ -4613,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 {
             /**
@@ -4671,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.
@@ -4681,7 +5008,13 @@ export declare 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;
             /**
@@ -5007,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.
@@ -5042,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.
@@ -5062,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 {
             /**
@@ -5240,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.
      *
@@ -5289,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.
@@ -5582,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.
      *