datadog_api_client 2.49.0 → 2.51.0

data/.generator/schemas/v1/openapi.yaml

@@ -979,8 +979,12 @@ components:
       properties:
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         audit_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         conditional_formats:
           description: List of conditional formats.
           example:
@@ -992,6 +996,8 @@ components:
           type: array
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         formulas:
           description: List of formulas that operate on queries.
           items:
@@ -999,14 +1005,23 @@ components:
           type: array
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
-          description: Widget query.
+          deprecated: true
+          description: Widget query. Deprecated - Use `queries` and `formulas` instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -1017,8 +1032,12 @@ components:
           $ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         sort:
           $ref: '#/components/schemas/WidgetSortBy'
         style:
@@ -1143,12 +1162,16 @@ components:
       properties:
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         change_type:
           $ref: '#/components/schemas/WidgetChangeType'
         compare_to:
           $ref: '#/components/schemas/WidgetCompareTo'
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         formulas:
           description: List of formulas that operate on queries.
           items:
@@ -1159,18 +1182,28 @@ components:
           type: boolean
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         order_by:
           $ref: '#/components/schemas/WidgetOrderBy'
         order_dir:
           $ref: '#/components/schemas/WidgetSort'
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
-          description: Query definition.
+          deprecated: true
+          description: Query definition. Deprecated - Use `queries` and `formulas`
+            instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -1181,8 +1214,12 @@ components:
           $ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         show_present:
           description: Whether to show the present value.
           type: boolean
@@ -1919,8 +1956,6 @@ components:
           description: "Array of one request object to display in the widget.\n\nSee
             the dedicated [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json)\n
             to learn how to build the `REQUEST_SCHEMA`."
-          example:
-          - q: host:X tags:Y
           items:
             $ref: '#/components/schemas/DistributionWidgetRequest'
           maxItems: 1
@@ -1975,10 +2010,14 @@ components:
       properties:
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         apm_stats_query:
           $ref: '#/components/schemas/ApmStatsQueryDefinition'
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         formulas:
           description: List of formulas that operate on queries.
           items:
@@ -1986,14 +2025,23 @@ components:
           type: array
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
-          description: Widget query.
+          deprecated: true
+          description: Widget query. Deprecated - Use `queries` and `formulas` instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -2004,12 +2052,20 @@ components:
           $ref: '#/components/schemas/DistributionWidgetHistogramRequestQuery'
         request_type:
           $ref: '#/components/schemas/WidgetHistogramRequestType'
+          description: Distribution of point values for distribution metrics. Renders
+            a histogram of raw metric data points.
         response_format:
           $ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
+          description: Distribution of aggregated grouped queries. Use `request_type`
+            instead for distribution of point values from distribution metrics.
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         style:
           $ref: '#/components/schemas/WidgetStyle'
       type: object
@@ -2962,10 +3018,7 @@ components:
         data_source:
           $ref: '#/components/schemas/FormulaAndFunctionEventsDataSource'
         group_by:
-          description: Group by options.
-          items:
-            $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupBy'
-          type: array
+          $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupByConfig'
         indexes:
           description: An array of index names to query in the stream. Omit or use
             `[]` to query all indexes at once.
@@ -3037,6 +3090,40 @@ components:
       required:
       - facet
       type: object
+    FormulaAndFunctionEventQueryGroupByConfig:
+      description: Group by configuration for a formula and functions events query.
+        Accepts either a list of facet objects or a flat object that specifies a list
+        of facet fields.
+      oneOf:
+      - $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupByList'
+      - $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupByFields'
+    FormulaAndFunctionEventQueryGroupByFields:
+      description: Flat group by configuration using multiple event facet fields.
+      properties:
+        fields:
+          description: List of event facets to group by.
+          example:
+          - hostname
+          - service
+          items:
+            description: Event facet.
+            type: string
+          type: array
+        limit:
+          description: Number of groups to return.
+          example: 10
+          format: int64
+          type: integer
+        sort:
+          $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupBySort'
+      required:
+      - fields
+      type: object
+    FormulaAndFunctionEventQueryGroupByList:
+      description: List of objects used to group by.
+      items:
+        $ref: '#/components/schemas/FormulaAndFunctionEventQueryGroupBy'
+      type: array
     FormulaAndFunctionEventQueryGroupBySort:
       description: Options for sorting group by results.
       properties:
@@ -3735,8 +3822,12 @@ components:
           type: array
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
-          description: The widget metrics query.
+          deprecated: true
+          description: The widget metrics query. Deprecated - Use `queries` and `formulas`
+            instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -3749,8 +3840,12 @@ components:
           $ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         sort:
           $ref: '#/components/schemas/WidgetSortBy'
         style:
@@ -3927,7 +4022,9 @@ components:
             $ref: '#/components/schemas/WidgetCustomLink'
           type: array
         events:
-          description: List of widget events.
+          deprecated: true
+          description: List of widget events. Deprecated - Use `overlay` request type
+            instead.
           items:
             $ref: '#/components/schemas/WidgetEvent'
           type: array
@@ -3987,8 +4084,12 @@ components:
       properties:
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         event_query:
           $ref: '#/components/schemas/EventQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         formulas:
           description: List of formulas that operate on queries.
           items:
@@ -3996,14 +4097,23 @@ components:
           type: array
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
-          description: Widget query.
+          deprecated: true
+          description: Widget query. Deprecated - Use `queries` and `formulas` instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -4014,12 +4124,19 @@ components:
           $ref: '#/components/schemas/FormulaAndFunctionMetricQueryDefinition'
         request_type:
           $ref: '#/components/schemas/WidgetHistogramRequestType'
+          description: Applicable only for distribution of point values for distribution
+            metrics.
         response_format:
           $ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
+          description: Applicable only for distribution of aggregated grouped queries.
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         style:
           $ref: '#/components/schemas/WidgetStyle'
       type: object
@@ -4134,23 +4251,39 @@ components:
       properties:
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
           description: Query definition.
           type: string
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
       type: object
     HostMapWidgetDefinition:
       description: The host map widget graphs any metric across your hosts using the
@@ -4475,10 +4608,11 @@ components:
           type: array
       type: object
     HourlyUsageAttributionUsageType:
-      description: 'Supported products for hourly usage attribution requests.
+      description: 'Supported products for hourly usage attribution requests. Usage
+        types are in the format `<usage_type>_usage`.
 
-        The following values have been **deprecated**: `estimated_indexed_spans_usage`,
-        `estimated_ingested_spans_usage`.'
+        To obtain the complete list of valid usage types, make a request to the [Get
+        usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).'
       enum:
       - api_usage
       - apm_fargate_usage
@@ -4490,6 +4624,8 @@ components:
       - asm_serverless_traced_invocations_percentage
       - bits_ai_investigations_usage
       - browser_usage
+      - ci_code_coverage_committers_percentage
+      - ci_code_coverage_committers_usage
       - ci_pipeline_indexed_spans_usage
       - ci_test_indexed_spans_usage
       - ci_visibility_itr_usage
@@ -4514,6 +4650,7 @@ components:
       - estimated_indexed_spans_usage
       - estimated_ingested_spans_usage
       - fargate_usage
+      - flex_logs_starter
       - flex_stored_logs
       - functions_usage
       - incident_management_monthly_active_users_usage
@@ -4574,6 +4711,8 @@ components:
       - ASM_SERVERLESS_TRACED_INVOCATIONS_PERCENTAGE
       - BITS_AI_INVESTIGATIONS_USAGE
       - BROWSER_USAGE
+      - CI_CODE_COVERAGE_COMMITTERS_PERCENTAGE
+      - CI_CODE_COVERAGE_COMMITTERS_USAGE
       - CI_PIPELINE_INDEXED_SPANS_USAGE
       - CI_TEST_INDEXED_SPANS_USAGE
       - CI_VISIBILITY_ITR_USAGE
@@ -4598,6 +4737,7 @@ components:
       - ESTIMATED_INDEXED_SPANS_USAGE
       - ESTIMATED_INGESTED_SPANS_USAGE
       - FARGATE_USAGE
+      - FLEX_LOGS_STARTER
       - FLEX_STORED_LOGS
       - FUNCTIONS_USAGE
       - INCIDENT_MANAGEMENT_MONTHLY_ACTIVE_USERS_USAGE
@@ -6152,6 +6292,16 @@ components:
           example: 15
           format: int64
           type: integer
+        tags:
+          description: A list of tags associated with the index. Tags must be in `key:value`
+            format.
+          example:
+          - team:backend
+          - env:production
+          items:
+            description: A single tag using the format `key:value`.
+            type: string
+          type: array
       required:
       - name
       - filter
@@ -6239,6 +6389,16 @@ components:
           example: 15
           format: int64
           type: integer
+        tags:
+          description: A list of tags associated with the index. Tags must be in `key:value`
+            format.
+          example:
+          - team:backend
+          - env:production
+          items:
+            description: A single tag using the format `key:value`.
+            type: string
+          type: array
       required:
       - filter
       type: object
@@ -7973,6 +8133,7 @@ components:
       - spans
       - database_queries
       - network
+      - network_path
       example: rum
       type: string
       x-enum-varnames:
@@ -7985,6 +8146,7 @@ components:
       - SPANS
       - DATABASE_QUERIES
       - NETWORK
+      - NETWORK_PATH
     MonitorFormulaAndFunctionQueryDefinition:
       description: A formula and function query.
       oneOf:
@@ -8369,12 +8531,18 @@ components:
       - hide_query
       - hide_handles
       - hide_all
+      - hide_query_and_handles
+      - show_only_snapshot
+      - hide_handles_and_footer
       type: string
       x-enum-varnames:
       - SHOW_ALL
       - HIDE_QUERY
       - HIDE_HANDLES
       - HIDE_ALL
+      - HIDE_QUERY_AND_HANDLES
+      - SHOW_ONLY_SNAPSHOT
+      - HIDE_HANDLES_AND_FOOTER
     MonitorOptionsSchedulingOptions:
       description: Configuration options for scheduling.
       properties:
@@ -8830,6 +8998,7 @@ components:
       - network-performance alert
       - cost alert
       - data-quality alert
+      - network-path alert
       example: query alert
       type: string
       x-enum-varnames:
@@ -8853,6 +9022,7 @@ components:
       - NETWORK_PERFORMANCE_ALERT
       - COST_ALERT
       - DATA_QUALITY_ALERT
+      - NETWORK_PATH_ALERT
     MonitorUpdateRequest:
       description: Object describing a monitor update request.
       properties:
@@ -8996,7 +9166,11 @@ components:
           type: array
       type: object
     MonthlyUsageAttributionSupportedMetrics:
-      description: Supported metrics for monthly usage attribution requests.
+      description: 'Supported metrics for monthly usage attribution requests. Usage
+        types are in the format `<usage_type>_usage`.
+
+        To obtain the complete list of valid usage types, make a request to the [Get
+        usage attribution types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).'
       enum:
       - api_usage
       - api_percentage
@@ -9056,6 +9230,8 @@ components:
       - estimated_ingested_spans_percentage
       - fargate_usage
       - fargate_percentage
+      - flex_logs_starter_usage
+      - flex_logs_starter_percentage
       - flex_stored_logs_usage
       - flex_stored_logs_percentage
       - functions_usage
@@ -9219,6 +9395,8 @@ components:
       - ESTIMATED_INGESTED_SPANS_PERCENTAGE
       - FARGATE_USAGE
       - FARGATE_PERCENTAGE
+      - FLEX_LOGS_STARTER_USAGE
+      - FLEX_LOGS_STARTER_PERCENTAGE
       - FLEX_STORED_LOGS_USAGE
       - FLEX_STORED_LOGS_PERCENTAGE
       - FUNCTIONS_USAGE
@@ -9323,10 +9501,7 @@ components:
       - SCA_FARGATE_PERCENTAGE
       - ALL
     MonthlyUsageAttributionValues:
-      description: 'Fields in Usage Summary by tag(s).
-
-        The following values have been **deprecated**: `estimated_indexed_spans_usage`,
-        `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`.'
+      description: Fields in Usage Summary by tag(s).
       properties:
         api_percentage:
           description: The percentage of synthetic API test usage by tag(s).
@@ -9406,6 +9581,14 @@ components:
           description: The synthetic browser test usage by tag(s).
           format: double
           type: number
+        ci_code_coverage_committers_percentage:
+          description: The percentage of Code Coverage committers usage by tag(s).
+          format: double
+          type: number
+        ci_code_coverage_committers_usage:
+          description: The total Code Coverage committers usage by tag(s).
+          format: double
+          type: number
         ci_pipeline_indexed_spans_percentage:
           description: The percentage of CI Pipeline Indexed Spans usage by tag(s).
           format: double
@@ -9590,6 +9773,14 @@ components:
           description: The Fargate usage by tags.
           format: double
           type: number
+        flex_logs_starter_percentage:
+          description: The percentage of Flex Logs Starter usage by tags.
+          format: double
+          type: number
+        flex_logs_starter_usage:
+          description: The Flex Logs Starter usage by tags.
+          format: double
+          type: number
         flex_stored_logs_percentage:
           description: The percentage of Flex Stored Logs usage by tags.
           format: double
@@ -11386,8 +11577,12 @@ components:
           $ref: '#/components/schemas/WidgetAggregator'
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         audit_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         conditional_formats:
           description: List of conditional formats.
           items:
@@ -11395,6 +11590,8 @@ components:
           type: array
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         formulas:
           description: List of formulas that operate on queries.
           items:
@@ -11402,14 +11599,23 @@ components:
           type: array
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
-          description: TODO.
+          deprecated: true
+          description: Widget query. Deprecated - Use `queries` and `formulas` instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -11420,8 +11626,12 @@ components:
           $ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
       type: object
     ReferenceTableLogsLookupProcessor:
       description: '**Note**: Reference Tables are in public beta.
@@ -11856,6 +12066,60 @@ components:
           example: UTC
           type: string
       type: object
+    SLOCountDefinition:
+      description: 'A count-based (metric) SLI specification, composed of three parts:
+        the good events formula, the total events formula,
+
+        and the underlying queries.'
+      example:
+        good_events_formula: query1 - query2
+        queries:
+        - data_source: metrics
+          name: query1
+          query: sum:trace.servlet.request.hits{*} by {env}.as_count()
+        - data_source: metrics
+          name: query2
+          query: sum:trace.servlet.request.errors{*} by {env}.as_count()
+        total_events_formula: query1
+      properties:
+        good_events_formula:
+          $ref: '#/components/schemas/SLOFormula'
+        queries:
+          example:
+          - data_source: metrics
+            name: query1
+            query: sum:trace.servlet.request.hits{*} by {env}.as_count()
+          items:
+            $ref: '#/components/schemas/SLODataSourceQueryDefinition'
+          minItems: 1
+          type: array
+        total_events_formula:
+          $ref: '#/components/schemas/SLOFormula'
+      required:
+      - good_events_formula
+      - total_events_formula
+      - queries
+      type: object
+    SLOCountSpec:
+      additionalProperties: false
+      description: A metric SLI specification.
+      example:
+        count:
+          good_events_formula: query1 - query2
+          queries:
+          - data_source: metrics
+            name: query1
+            query: sum:trace.servlet.request.hits{*} by {env}.as_count()
+          - data_source: metrics
+            name: query2
+            query: sum:trace.servlet.request.errors{*} by {env}.as_count()
+          total_events_formula: query1
+      properties:
+        count:
+          $ref: '#/components/schemas/SLOCountDefinition'
+      required:
+      - count
+      type: object
     SLOCreator:
       description: The creator of the SLO
       nullable: true
@@ -12703,8 +12967,12 @@ components:
           type: string
         query:
           $ref: '#/components/schemas/ServiceLevelObjectiveQuery'
+          description: The metric query used to define a count-based SLO as the ratio
+            of good events to total events.
         sli_specification:
           $ref: '#/components/schemas/SLOSliSpec'
+          description: A generic SLI specification. This is currently used for time-slice
+            and count-based (metric) SLOs only.
         tags:
           description: 'A list of tags associated with this service level objective.
 
@@ -12760,10 +13028,11 @@ components:
           type: number
       type: object
     SLOSliSpec:
-      description: A generic SLI specification. This is currently used for time-slice
-        SLOs only.
+      description: A generic SLI specification. This is used for time-slice and count-based
+        (metric) SLOs only.
       oneOf:
       - $ref: '#/components/schemas/SLOTimeSliceSpec'
+      - $ref: '#/components/schemas/SLOCountSpec'
     SLOState:
       description: State of the SLO.
       enum:
@@ -13094,23 +13363,39 @@ components:
           $ref: '#/components/schemas/ScatterplotWidgetAggregator'
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
           description: Query definition.
           type: string
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
       type: object
     ScatterPlotWidgetDefinition:
       description: The scatter plot visualization allows you to graph a chosen scope
@@ -13915,7 +14200,8 @@ components:
       - type
       type: object
     ServiceLevelObjectiveQuery:
-      description: 'A metric-based SLO. **Required if type is `metric`**. Note that
+      description: 'A count-based (metric) SLO query. This field is superseded by
+        `sli_specification` but is retained for backwards compatibility. Note that
         Datadog only allows the sum by aggregator
 
         to be used because this will sum up all request counts instead of averaging
@@ -14895,10 +15181,16 @@ components:
       properties:
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         audit_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         formulas:
           description: List of formulas that operate on queries.
           items:
@@ -14906,14 +15198,23 @@ components:
           type: array
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
-          description: Widget query.
+          deprecated: true
+          description: Widget query. Deprecated - Use `queries` and `formulas` instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -14924,8 +15225,12 @@ components:
           $ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         style:
           $ref: '#/components/schemas/WidgetStyle'
       type: object
@@ -15616,6 +15921,8 @@ components:
       - grpcMetadata
       - grpcProto
       - connection
+      - multiNetworkHop
+      - jitter
       example: statusCode
       type: string
       x-enum-varnames:
@@ -15638,6 +15945,8 @@ components:
       - GRPC_METADATA
       - GRPC_PROTO
       - CONNECTION
+      - MULTI_NETWORK_HOP
+      - JITTER
     SyntheticsAssertionXPathOperator:
       description: Assertion operator to apply.
       enum:
@@ -17622,8 +17931,10 @@ components:
           type: string
       type: object
     SyntheticsRestrictedRoles:
+      deprecated: true
       description: A list of role identifiers that can be pulled from the Roles API,
-        for restricting read and write access.
+        for restricting read and write access. This field is deprecated. Use the restriction
+        policies API to manage permissions.
       example:
       - xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
       items:
@@ -18019,16 +18330,18 @@ components:
       - WEBSOCKET
       - GRPC
     SyntheticsTestDetailsType:
-      description: Type of the Synthetic test, either `api` or `browser`.
+      description: Type of the Synthetic test.
       enum:
       - api
       - browser
       - mobile
+      - network
       type: string
       x-enum-varnames:
       - API
       - BROWSER
       - MOBILE
+      - NETWORK
     SyntheticsTestDetailsWithoutSteps:
       description: Object containing details about your Synthetic test, without test
         steps.
@@ -18257,12 +18570,18 @@ components:
       - hide_all
       - hide_query
       - hide_handles
+      - hide_query_and_handles
+      - show_only_snapshot
+      - hide_handles_and_footer
       type: string
       x-enum-varnames:
       - SHOW_ALL
       - HIDE_ALL
       - HIDE_QUERY
       - HIDE_HANDLES
+      - HIDE_QUERY_AND_HANDLES
+      - SHOW_ONLY_SNAPSHOT
+      - HIDE_HANDLES_AND_FOOTER
     SyntheticsTestOptionsRetry:
       description: Object describing the retry strategy to apply to a Synthetic test.
       properties:
@@ -18493,6 +18812,10 @@ components:
           description: Content of the file.
           maxLength: 3145728
           type: string
+        encoding:
+          description: Encoding of the file content. The only supported value is `base64`,
+            indicating the `content` field contains base64-encoded data.
+          type: string
         name:
           description: Name of the file.
           maxLength: 1500
@@ -18914,6 +19237,8 @@ components:
           type: string
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         apm_stats_query:
           $ref: '#/components/schemas/ApmStatsQueryDefinition'
         cell_display_mode:
@@ -18928,6 +19253,8 @@ components:
           type: array
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         formulas:
           description: List of formulas that operate on queries.
           items:
@@ -18940,16 +19267,26 @@ components:
           type: integer
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         order:
           $ref: '#/components/schemas/WidgetSort'
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
-          description: Query definition.
+          deprecated: true
+          description: Query definition. Deprecated - Use `queries` and `formulas`
+            instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -18960,8 +19297,12 @@ components:
           $ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         sort:
           $ref: '#/components/schemas/WidgetSortBy'
         text_formats:
@@ -19205,7 +19546,9 @@ components:
             $ref: '#/components/schemas/WidgetCustomLink'
           type: array
         events:
-          description: List of widget events.
+          deprecated: true
+          description: List of widget events. Deprecated - Use `overlay` request type
+            instead.
           items:
             $ref: '#/components/schemas/WidgetEvent'
           type: array
@@ -19307,12 +19650,18 @@ components:
       properties:
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         audit_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         display_type:
           $ref: '#/components/schemas/WidgetDisplayType'
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         formulas:
           description: List of formulas that operate on queries.
           items:
@@ -19320,6 +19669,8 @@ components:
           type: array
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         metadata:
           description: Used to define expression aliases.
           items:
@@ -19327,15 +19678,22 @@ components:
           type: array
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         on_right_yaxis:
           description: Whether or not to display a second y-axis on the right.
           type: boolean
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
-          description: Widget query.
+          deprecated: true
+          description: Widget query. Deprecated - Use `queries` and `formulas` instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -19346,8 +19704,12 @@ components:
           $ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         style:
           $ref: '#/components/schemas/WidgetRequestStyle'
       type: object
@@ -19434,8 +19796,12 @@ components:
       properties:
         apm_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         audit_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         conditional_formats:
           description: List of conditional formats.
           example:
@@ -19448,6 +19814,8 @@ components:
           type: array
         event_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         formulas:
           description: List of formulas that operate on queries.
           items:
@@ -19455,14 +19823,23 @@ components:
           type: array
         log_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         network_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         process_query:
           $ref: '#/components/schemas/ProcessQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         profile_metrics_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         q:
-          description: Widget query.
+          deprecated: true
+          description: Widget query. Deprecated - Use `queries` and `formulas` instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -19473,8 +19850,12 @@ components:
           $ref: '#/components/schemas/FormulaAndFunctionResponseFormat'
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+          deprecated: true
+          description: Deprecated - Use `queries` and `formulas` instead.
         sort:
           $ref: '#/components/schemas/WidgetSortBy'
         style:
@@ -19698,7 +20079,9 @@ components:
             $ref: '#/components/schemas/WidgetFormula'
           type: array
         q:
-          description: The widget metrics query.
+          deprecated: true
+          description: The widget metrics query. Deprecated - Use `queries` and `formulas`
+            instead.
           type: string
         queries:
           description: List of queries that can be returned directly or used in formulas.
@@ -19866,7 +20249,8 @@ components:
           description: The account public ID.
           type: string
         billing_plan:
-          description: The billing plan.
+          deprecated: true
+          description: The billing plan (metadata). (Deprecated from June 2026)
           type: string
         end_date:
           description: Shows the last date of usage.
@@ -21345,6 +21729,16 @@ components:
             current date for all organizations (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
+        ccm_spend_monitored_ent_last:
+          description: Shows the last value of the amount of cloud spend monitored
+            for Enterprise over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_spend_monitored_pro_last:
+          description: Shows the last value of the amount of cloud spend monitored
+            for Pro over all hours in the current date for all organizations.
+          format: int64
+          type: integer
         ci_pipeline_indexed_spans_sum:
           description: Shows the sum of all CI pipeline indexed spans over all hours
             in the current month for all organizations.
@@ -22477,6 +22871,16 @@ components:
             current date for the given org (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
+        ccm_spend_monitored_ent_last:
+          description: Shows the last value of the amount of cloud spend monitored
+            for Enterprise over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_spend_monitored_pro_last:
+          description: Shows the last value of the amount of cloud spend monitored
+            for Pro over all hours in the current date for the given org.
+          format: int64
+          type: integer
         ci_pipeline_indexed_spans_sum:
           description: Shows the sum of all CI pipeline indexed spans over all hours
             in the current date for the given org.
@@ -23621,6 +24025,16 @@ components:
             2024).
           format: int64
           type: integer
+        ccm_spend_monitored_ent_last_sum:
+          description: Shows the sum of the last value of the amount of cloud spend
+            monitored for Enterprise in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_spend_monitored_pro_last_sum:
+          description: Shows the sum of the last value of the amount of cloud spend
+            monitored for Pro in the current month for all organizations.
+          format: int64
+          type: integer
         ci_pipeline_indexed_spans_agg_sum:
           description: Shows the sum of all CI pipeline indexed spans over all hours
             in the current month for all organizations.
@@ -25328,6 +25742,7 @@ components:
       - LINE
       - OVERLAY
     WidgetEvent:
+      deprecated: true
       description: 'Event overlay control options.
 
 
@@ -25495,7 +25910,9 @@ components:
       - CHECK
       - CLUSTER
     WidgetHistogramRequestType:
-      description: Request type for the histogram request.
+      description: Request type for distribution of point values for distribution
+        metrics. Query space aggregator must be `histogram:<metric name>` for points
+        distributions.
       enum:
       - histogram
       example: histogram
@@ -25795,8 +26212,8 @@ components:
       description: Used for fixed span times, such as 'March 1 to March 7'.
       properties:
         from:
-          description: Start time in seconds since epoch.
-          example: 1712080128
+          description: Start time in milliseconds since epoch.
+          example: 1712080128000
           format: int64
           minimum: 0
           type: integer
@@ -25804,8 +26221,8 @@ components:
           description: Whether to hide incomplete cost data in the widget.
           type: boolean
         to:
-          description: End time in seconds since epoch.
-          example: 1712083128
+          description: End time in milliseconds since epoch.
+          example: 1712083128000
           format: int64
           minimum: 0
           type: integer
@@ -25934,6 +26351,8 @@ components:
           $ref: '#/components/schemas/WidgetLineType'
         line_width:
           $ref: '#/components/schemas/WidgetLineWidth'
+        order_by:
+          $ref: '#/components/schemas/WidgetStyleOrderBy'
         palette:
           description: Color palette to apply to the widget.
           type: string
@@ -25996,6 +26415,19 @@ components:
           description: Color palette to apply to the widget.
           type: string
       type: object
+    WidgetStyleOrderBy:
+      description: 'How to order series in timeseries visualizations.
+
+        - `tags`: Order series alphabetically by tag name (default behavior)
+
+        - `values`: Order series by their current metric values (typically descending)'
+      enum:
+      - tags
+      - values
+      type: string
+      x-enum-varnames:
+      - TAGS
+      - VALUES
     WidgetSummaryType:
       description: Which summary type should be used.
       enum:
@@ -31643,10 +32075,11 @@ paths:
         alert`\n- watchdog: `event-v2 alert`\n- event-v2: `event-v2 alert`\n- audit:
         `audit alert`\n- error-tracking: `error-tracking alert`\n- database-monitoring:
         `database-monitoring alert`\n- network-performance: `network-performance alert`\n-
-        cloud cost: `cost alert`\n\n**Notes**:\n- Synthetic monitors are created through
-        the Synthetics API. See the [Synthetics API](https://docs.datadoghq.com/api/latest/synthetics/)
-        documentation for more information.\n- Log monitors require an unscoped App
-        Key.\n\n#### Query Types\n\n##### Metric Alert Query\n\nExample: `time_aggr(time_window):space_aggr:metric{tags}
+        cloud cost: `cost alert`\n- network-path: `network-path alert`\n\n**Notes**:\n-
+        Synthetic monitors are created through the Synthetics API. See the [Synthetics
+        API](https://docs.datadoghq.com/api/latest/synthetics/) documentation for
+        more information.\n- Log monitors require an unscoped App Key.\n\n#### Query
+        Types\n\n##### Metric Alert Query\n\nExample: `time_aggr(time_window):space_aggr:metric{tags}
         [by {key}] operator #`\n\n- `time_aggr`: avg, sum, max, min, change, or pct_change\n-
         `time_window`: `last_#m` (with `#` between 1 and 10080 depending on the monitor
         type) or `last_#h`(with `#` between 1 and 168 depending on the monitor type)
@@ -31776,7 +32209,15 @@ paths:
         \   - for `threshold` supports `<`, `<=`, `>`, `>=`, `==`, or `!=`\n    -
         for `change` supports `>`, `<`\n    - for `anomaly` supports `>=`\n    - for
         `forecast` supports `>`\n- `#` an integer or decimal number used to set the
-        threshold."
+        threshold.\n\n**Network Path Alert Query**\n\nExample: `network-path(query).index(index_name).rollup(rollup_method[,
+        measure]).last(time_window) operator #`\n\n- `query` The search query - following
+        the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).\n-
+        `index_name` The data type to monitor on - supports `netpath-path` and `netpath-hop`.\n-
+        `rollup_method` The stats roll-up method - supports `count`, `avg`, and `cardinality`.\n-
+        `measure` For `avg` and cardinality `rollup_method` - specify the measure
+        or the facet name you want to use.\n- `time_window` #m (between 1 and 2880),
+        #h (between 1 and 48).\n- `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.\n-
+        `#` an integer or decimal number used to set the threshold."
       operationId: CreateMonitor
       requestBody:
         content:
@@ -35353,7 +35794,7 @@ paths:
     get:
       description: 'Get the detailed configuration associated with
 
-        a Synthetic Mobile test.'
+        a Synthetic mobile test.'
       operationId: GetMobileTest
       parameters:
       - description: The public ID of the test to get details from.
@@ -35390,7 +35831,7 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - synthetics_read
-      summary: Get a Mobile test
+      summary: Get a mobile test
       tags:
       - Synthetics
       x-permission:
@@ -35398,7 +35839,7 @@ paths:
         permissions:
         - synthetics_read
     put:
-      description: Edit the configuration of a Synthetic Mobile test.
+      description: Edit the configuration of a Synthetic mobile test.
       operationId: UpdateMobileTest
       parameters:
       - description: The public ID of the test to get details from.
@@ -35452,7 +35893,7 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - synthetics_write
-      summary: Edit a Mobile test
+      summary: Edit a mobile test
       tags:
       - Synthetics
       x-codegen-request-body-name: body
@@ -37066,10 +37507,7 @@ paths:
         code example:\n\n```\nresponse := GetHourlyUsageAttribution(start_month)\ncursor
         := response.metadata.pagination.next_record_id\nWHILE cursor != null BEGIN\n
         \ sleep(5 seconds)  # Avoid running into rate limit\n  response := GetHourlyUsageAttribution(start_month,
-        next_record_id=cursor)\n  cursor := response.metadata.pagination.next_record_id\nEND\n```\nThe
-        following values have been **deprecated**:\n    `estimated_indexed_spans_usage`,
-        `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`, `estimated_ingested_spans_percentage`,
-        `llm_observability_usage`, `llm_observability_percentage`."
+        next_record_id=cursor)\n  cursor := response.metadata.pagination.next_record_id\nEND\n```"
       operationId: GetHourlyUsageAttribution
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -37090,9 +37528,14 @@ paths:
         schema:
           format: date-time
           type: string
-      - description: 'Usage type to retrieve. The following values have been **deprecated**:
+      - description: 'Usage type to retrieve. Usage types are in the format `<usage_type>_usage`.
 
-          `estimated_indexed_spans_usage`, `estimated_ingested_spans_usage`.'
+          Example: `infra_host_usage`
+
+          To obtain the complete list of active usage types that can be used to replace
+
+          `<usage_type>` in the field names, make a request to the [Get usage attribution
+          types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).'
         in: query
         name: usage_type
         required: true
@@ -37645,10 +38088,15 @@ paths:
       - description: 'Comma-separated list of usage types to return, or `*` for all
           usage types.
 
-          The following values have been **deprecated**:
+          Usage types are in the format `<usage_type>_usage` and `<usage_type>_percentage`.
+
+          Example: `infra_host_usage,infra_host_percentage`
+
+          To obtain the complete list of usage attribution types that can be used
+          to replace
 
-          `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`,
-          `estimated_ingested_spans_percentage`, `llm_observability_usage`, `llm_observability_percentage`.'
+          `<usage_type>` in the field names, make a request to the [Get usage attribution
+          types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).'
         in: query
         name: fields
         required: true
@@ -37660,12 +38108,15 @@ paths:
         required: false
         schema:
           $ref: '#/components/schemas/UsageSortDirection'
-      - description: 'The field to sort by.
+      - description: 'The field to sort by. Sort fields are in the format `<usage_type>_usage`.
 
-          The following values have been **deprecated**:
+          Example: `infra_host_usage`
 
-          `estimated_indexed_spans_usage`, `estimated_indexed_spans_percentage`, `estimated_ingested_spans_usage`,
-          `estimated_ingested_spans_percentage`.'
+          To obtain the complete list of usage attribution types that can be used
+          to replace
+
+          `<usage_type>` in the field names, make a request to the [Get usage attribution
+          types API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-attribution-types).'
         in: query
         name: sort_name
         required: false
@@ -39357,18 +39808,21 @@ tags:
   name: Slack Integration
 - description: Take graph snapshots using the API.
   name: Snapshots
-- description: 'Datadog Synthetic Monitoring uses simulated user requests and browser
-    rendering to help you ensure uptime,
+- description: 'Synthetic tests use simulated requests and actions so you can monitor
+    the availability and performance of systems and applications. Datadog supports
+    the following types of synthetic tests:
+
+    - [API tests](https://docs.datadoghq.com/synthetics/api_tests/)
+
+    - [Browser tests](https://docs.datadoghq.com/synthetics/browser_tests)
 
-    identify regional issues, and track your application performance. Synthetic tests
-    come in
+    - [Network Path tests](https://docs.datadoghq.com/synthetics/network_path_tests/)
 
-    two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/?tab=httptest)
+    - [Mobile Application tests](https://docs.datadoghq.com/synthetics/mobile_app_testing)
 
-    and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You
-    can use Datadog''s API to
 
-    manage both test types programmatically.
+    You can use the Datadog API to create, manage, and organize tests and test suites
+    programmatically.
 
 
     For more information, see the [Synthetic Monitoring documentation](https://docs.datadoghq.com/synthetics/).'