RubyGems - datadog_api_client - Versions diffs - 1.10.0 → 2.0.1 - Mend

datadog_api_client 1.10.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (351) hide show

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

@@ -1299,6 +1299,96 @@ components:
           type: integer
       readOnly: true
       type: object
+    DistributionPoint:
+      description: Array of distribution points.
+      example:
+      - 1575317847.0
+      - - 0.5
+        - 1.0
+      items:
+        description: List of distribution point.
+        oneOf:
+        - $ref: '#/components/schemas/DistributionPointTimestamp'
+        - $ref: '#/components/schemas/DistributionPointData'
+      maxItems: 2
+      minItems: 2
+      type: array
+    DistributionPointData:
+      description: Distribution point data.
+      items:
+        description: List of distribution point data.
+        format: double
+        type: number
+      type: array
+    DistributionPointTimestamp:
+      description: Distribution point timestamp. It should be in seconds and current.
+      format: double
+      type: number
+    DistributionPointsContentEncoding:
+      description: HTTP header used to compress the media-type.
+      enum:
+      - deflate
+      type: string
+      x-enum-varnames:
+      - DEFLATE
+    DistributionPointsPayload:
+      description: The distribution points payload.
+      properties:
+        series:
+          description: A list of distribution points series to submit to Datadog.
+          example:
+          - metric: system.load.1
+            points:
+            - - 1475317847.0
+              - - 1.0
+                - 2.0
+          items:
+            $ref: '#/components/schemas/DistributionPointsSeries'
+          type: array
+      required:
+      - series
+      type: object
+    DistributionPointsSeries:
+      description: A distribution points metric to submit to Datadog.
+      properties:
+        host:
+          description: The name of the host that produced the distribution point metric.
+          example: test.example.com
+          type: string
+        metric:
+          description: The name of the distribution points metric.
+          example: system.load.1
+          type: string
+        points:
+          description: Points relating to the distribution point metric. All points
+            must be tuples with timestamp and a list of values (cannot be a string).
+            Timestamps should be in POSIX time in seconds.
+          items:
+            $ref: '#/components/schemas/DistributionPoint'
+          type: array
+        tags:
+          description: A list of tags associated with the distribution point metric.
+          example:
+          - environment:test
+          items:
+            description: Individual tags.
+            type: string
+          type: array
+        type:
+          $ref: '#/components/schemas/DistributionPointsType'
+      required:
+      - metric
+      - points
+      type: object
+    DistributionPointsType:
+      default: distribution
+      description: The type of the distribution point.
+      enum:
+      - distribution
+      example: distribution
+      type: string
+      x-enum-varnames:
+      - DISTRIBUTION
     DistributionWidgetDefinition:
       description: "The Distribution visualization is another way of showing metrics\naggregated
         across one or several tags, such as hosts.\nUnlike the heat map, a distribution
@@ -1359,6 +1449,25 @@ components:
       type: string
       x-enum-varnames:
       - DISTRIBUTION
+    DistributionWidgetHistogramRequestQuery:
+      description: Query definition for Distribution Widget Histogram Request
+      example:
+        data_source: metrics
+        name: query1
+        query: histogram:trace.Load{*}
+      oneOf:
+      - $ref: '#/components/schemas/FormulaAndFunctionMetricQueryDefinition'
+      - $ref: '#/components/schemas/FormulaAndFunctionEventQueryDefinition'
+      - $ref: '#/components/schemas/FormulaAndFunctionApmResourceStatsQueryDefinition'
+      type: object
+    DistributionWidgetHistogramRequestType:
+      description: Request type for the histogram request.
+      enum:
+      - histogram
+      example: histogram
+      type: string
+      x-enum-varnames:
+      - HISTOGRAM
     DistributionWidgetRequest:
       description: Updated distribution widget.
       properties:
@@ -1379,6 +1488,10 @@ components:
         q:
           description: Widget query.
           type: string
+        query:
+          $ref: '#/components/schemas/DistributionWidgetHistogramRequestQuery'
+        request_type:
+          $ref: '#/components/schemas/DistributionWidgetHistogramRequestType'
         rum_query:
           $ref: '#/components/schemas/LogQueryDefinition'
         security_query:
@@ -2159,6 +2272,7 @@ components:
       - error_rate
       - hits
       - latency_avg
+      - latency_distribution
       - latency_max
       - latency_p50
       - latency_p75
@@ -2172,6 +2286,7 @@ components:
       - ERROR_RATE
       - HITS
       - LATENCY_AVG
+      - LATENCY_DISTRIBUTION
       - LATENCY_MAX
       - LATENCY_P50
       - LATENCY_P75
@@ -3511,10 +3626,19 @@ components:
       enum:
       - api_usage
       - apm_host_usage
+      - appsec_usage
       - browser_usage
       - container_usage
+      - cspm_containers_usage
+      - cspm_hosts_usage
       - custom_timeseries_usage
+      - cws_containers_usage
+      - cws_hosts_usage
+      - dbm_hosts_usage
+      - dbm_queries_usage
       - estimated_indexed_logs_usage
+      - estimated_indexed_spans_usage
+      - estimated_ingested_spans_usage
       - fargate_usage
       - functions_usage
       - indexed_logs_usage
@@ -3528,10 +3652,19 @@ components:
       x-enum-varnames:
       - API_USAGE
       - APM_HOST_USAGE
+      - APPSEC_USAGE
       - BROWSER_USAGE
       - CONTAINER_USAGE
+      - CSPM_CONTAINERS_USAGE
+      - CSPM_HOSTS_USAGE
       - CUSTOM_TIMESERIES_USAGE
+      - CWS_CONTAINERS_USAGE
+      - CWS_HOSTS_USAGE
+      - DBM_HOSTS_USAGE
+      - DBM_QUERIES_USAGE
       - ESTIMATED_INDEXED_LOGS_USAGE
+      - ESTIMATED_INDEXED_SPANS_USAGE
+      - ESTIMATED_INGESTED_SPANS_USAGE
       - FARGATE_USAGE
       - FUNCTIONS_USAGE
       - INDEXED_LOGS_USAGE
@@ -3678,6 +3811,23 @@ components:
           description: List of IPv6 prefixes by location.
           type: object
       type: object
+    IPPrefixesSyntheticsPrivateLocations:
+      description: Available prefix information for the Synthetics Private Locations
+        endpoints.
+      properties:
+        prefixes_ipv4:
+          description: List of IPv4 prefixes.
+          items:
+            description: IPv4 prefix
+            type: string
+          type: array
+        prefixes_ipv6:
+          description: List of IPv6 prefixes.
+          items:
+            description: IPv6 prefix
+            type: string
+          type: array
+      type: object
     IPPrefixesWebhooks:
       description: Available prefix information for the Webhook endpoints.
       properties:
@@ -3713,6 +3863,8 @@ components:
           $ref: '#/components/schemas/IPPrefixesProcess'
         synthetics:
           $ref: '#/components/schemas/IPPrefixesSynthetics'
+        synthetics-private-locations:
+          $ref: '#/components/schemas/IPPrefixesSyntheticsPrivateLocations'
         version:
           description: Version of the IP list.
           example: 11
@@ -6648,7 +6800,7 @@ components:
           type: string
         tag_config_source:
           description: The source of the usage attribution tag configuration and the
-            selected tags in the format `<source_org_name>:<selected tag 1>///<selected
+            selected tags in the format `<source_org_name>:::<selected tag 1>///<selected
             tag 2>///<selected tag 3>`.
           type: string
         tags:
@@ -6695,14 +6847,32 @@ components:
       - api_percentage
       - apm_host_usage
       - apm_host_percentage
+      - appsec_usage
+      - appsec_percentage
       - browser_usage
       - browser_percentage
       - container_usage
       - container_percentage
+      - cspm_containers_percentage
+      - cspm_containers_usage
+      - cspm_hosts_percentage
+      - cspm_hosts_usage
       - custom_timeseries_usage
       - custom_timeseries_percentage
+      - cws_containers_percentage
+      - cws_containers_usage
+      - cws_hosts_percentage
+      - cws_hosts_usage
+      - dbm_hosts_percentage
+      - dbm_hosts_usage
+      - dbm_queries_percentage
+      - dbm_queries_usage
       - estimated_indexed_logs_usage
       - estimated_indexed_logs_percentage
+      - estimated_indexed_spans_usage
+      - estimated_indexed_spans_percentage
+      - estimated_ingested_spans_usage
+      - estimated_ingested_spans_percentage
       - fargate_usage
       - fargate_percentage
       - functions_usage
@@ -6728,14 +6898,32 @@ components:
       - API_PERCENTAGE
       - APM_HOST_USAGE
       - APM_HOST_PERCENTAGE
+      - APPSEC_USAGE
+      - APPSEC_PERCENTAGE
       - BROWSER_USAGE
       - BROWSER_PERCENTAGE
       - CONTAINER_USAGE
       - CONTAINER_PERCENTAGE
+      - CSPM_CONTAINERS_PERCENTAGE
+      - CSPM_CONTAINERS_USAGE
+      - CSPM_HOSTS_PERCENTAGE
+      - CSPM_HOSTS_USAGE
       - CUSTOM_TIMESERIES_USAGE
       - CUSTOM_TIMESERIES_PERCENTAGE
+      - CWS_CONTAINERS_PERCENTAGE
+      - CWS_CONTAINERS_USAGE
+      - CWS_HOSTS_PERCENTAGE
+      - CWS_HOSTS_USAGE
+      - DBM_HOSTS_PERCENTAGE
+      - DBM_HOSTS_USAGE
+      - DBM_QUERIES_PERCENTAGE
+      - DBM_QUERIES_USAGE
       - ESTIMATED_INDEXED_LOGS_USAGE
       - ESTIMATED_INDEXED_LOGS_PERCENTAGE
+      - ESTIMATED_INDEXED_SPANS_USAGE
+      - ESTIMATED_INDEXED_SPANS_PERCENTAGE
+      - ESTIMATED_INGESTED_SPANS_USAGE
+      - ESTIMATED_INGESTED_SPANS_PERCENTAGE
       - FARGATE_USAGE
       - FARGATE_PERCENTAGE
       - FUNCTIONS_USAGE
@@ -6774,6 +6962,15 @@ components:
           description: The APM host usage by tag(s).
           format: double
           type: number
+        appsec_percentage:
+          description: The percentage of Application Security Monitoring host usage
+            by tag(s).
+          format: double
+          type: number
+        appsec_usage:
+          description: The Application Security Monitoring host usage by tag(s).
+          format: double
+          type: number
         browser_percentage:
           description: The percentage of synthetic browser test usage by tag(s).
           format: double
@@ -6808,6 +7005,26 @@ components:
             is in private beta.
           format: double
           type: number
+        estimated_indexed_spans_percentage:
+          description: The percentage of estimated indexed spans usage by tag(s).
+            This field is in private beta.
+          format: double
+          type: number
+        estimated_indexed_spans_usage:
+          description: The estimated indexed spans usage by tag(s). This field is
+            in private beta.
+          format: double
+          type: number
+        estimated_ingested_spans_percentage:
+          description: The percentage of estimated ingested spans usage by tag(s).
+            This field is in private beta.
+          format: double
+          type: number
+        estimated_ingested_spans_usage:
+          description: The estimated ingested spans usage by tag(s). This field is
+            in private beta.
+          format: double
+          type: number
         fargate_percentage:
           description: The percentage of Fargate usage by tags.
           format: double
@@ -7705,6 +7922,13 @@ components:
           format: int64
           type: integer
       type: object
+    OrgDowngradedResponse:
+      description: Status of downgrade
+      properties:
+        message:
+          description: Information pertaining to the downgraded child organization.
+          type: string
+      type: object
     Organization:
       description: Create, edit, and manage organizations.
       properties:
@@ -7732,6 +7956,11 @@ components:
           $ref: '#/components/schemas/OrganizationSettings'
         subscription:
           $ref: '#/components/schemas/OrganizationSubscription'
+        trial:
+          description: Only available for MSP customers. Allows child organizations
+            to be created on a trial plan.
+          example: false
+          type: boolean
       type: object
     OrganizationBilling:
       deprecated: true
@@ -8476,7 +8705,7 @@ components:
           format: int64
           type: integer
         times:
-          description: An array of query timestamps in EPOCH milliseconds
+          description: An array of query timestamps in EPOCH milliseconds.
           example: []
           items:
             description: A timestamp in EPOCH milliseconds.
@@ -9344,6 +9573,164 @@ components:
       - formula
       - dimension
       type: object
+    SearchSLOResponse:
+      description: A search SLO response containing results from the search query.
+      properties:
+        data:
+          $ref: '#/components/schemas/SearchSLOResponseData'
+        links:
+          $ref: '#/components/schemas/SearchSLOResponseLinks'
+        meta:
+          $ref: '#/components/schemas/SearchSLOResponseMeta'
+      type: object
+    SearchSLOResponseData:
+      description: Data from search SLO response.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/SearchSLOResponseDataAttributes'
+        type:
+          description: Type of service level objective result.
+          example: ''
+          type: string
+      type: object
+    SearchSLOResponseDataAttributes:
+      description: Attributes
+      properties:
+        facets:
+          $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacets'
+        slo:
+          description: SLOs
+          items:
+            $ref: '#/components/schemas/ServiceLevelObjective'
+          type: array
+      type: object
+    SearchSLOResponseDataAttributesFacets:
+      description: Facets
+      properties:
+        all_tags:
+          description: All tags associated with an SLO.
+          items:
+            $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
+          type: array
+        creator_name:
+          description: Creator of an SLO.
+          items:
+            $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
+          type: array
+        env_tags:
+          description: Tags with the `env` tag key.
+          items:
+            $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
+          type: array
+        service_tags:
+          description: Tags with the `service` tag key.
+          items:
+            $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
+          type: array
+        slo_type:
+          description: Type of SLO.
+          items:
+            $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectInt'
+          type: array
+        target:
+          description: SLO Target
+          items:
+            $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectInt'
+          type: array
+        team_tags:
+          description: Tags with the `team` tag key.
+          items:
+            $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
+          type: array
+        timeframe:
+          description: Timeframes of SLOs.
+          items:
+            $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
+          type: array
+      type: object
+    SearchSLOResponseDataAttributesFacetsObjectInt:
+      description: Facet
+      properties:
+        count:
+          description: Count
+          format: int64
+          type: integer
+        name:
+          description: Facet
+          format: double
+          type: number
+      type: object
+    SearchSLOResponseDataAttributesFacetsObjectString:
+      description: Facet
+      properties:
+        count:
+          description: Count
+          format: int64
+          type: integer
+        name:
+          description: Facet
+          type: string
+      type: object
+    SearchSLOResponseLinks:
+      description: Pagination links.
+      properties:
+        first:
+          description: Link to last page.
+          type: string
+        last:
+          description: Link to first page.
+          type: string
+        next:
+          description: Link to the next page.
+          type: string
+        prev:
+          description: Link to previous page.
+          type: string
+        self:
+          description: Link to current page.
+          type: string
+      type: object
+    SearchSLOResponseMeta:
+      description: Searches metadata returned by the API.
+      properties:
+        pagination:
+          $ref: '#/components/schemas/SearchSLOResponseMetaPage'
+      type: object
+    SearchSLOResponseMetaPage:
+      description: Pagination metadata returned by the API.
+      properties:
+        first_number:
+          description: The first number.
+          format: int64
+          type: integer
+        last_number:
+          description: The last number.
+          format: int64
+          type: integer
+        next_number:
+          description: The next number.
+          format: int64
+          type: integer
+        number:
+          description: The page number.
+          format: int64
+          type: integer
+        prev_number:
+          description: The previous page number.
+          format: int64
+          type: integer
+        size:
+          description: The size of the response.
+          format: int64
+          type: integer
+        total:
+          description: The total number of SLOs in the response.
+          format: int64
+          type: integer
+        type:
+          description: Type of pagination.
+          type: string
+      type: object
     Series:
       description: 'A metric to submit to Datadog.
@@ -9472,7 +9859,7 @@ components:
           nullable: true
           type: string
         groups:
-          description: 'A list of (up to 20) monitor groups that narrow the scope
+          description: 'A list of (up to 100) monitor groups that narrow the scope
             of a monitor service level objective.
@@ -9521,8 +9908,8 @@ components:
             field.
-            Always included in service level objective responses for monitor service
-            level
+            Always included in service level objective responses for monitor-based
+            service level
             objectives (but may be empty). Ignored in create/update requests. Does
             not
@@ -9575,7 +9962,7 @@ components:
       - thresholds
       - type
     ServiceLevelObjectiveQuery:
-      description: 'A metric SLI query. **Required if type is `metric`**. Note that
+      description: 'A metric-based SLO. **Required if type is `metric`**. Note that
         Datadog only allows the sum by aggregator
         to be used because this will sum up all request counts instead of averaging
@@ -9611,7 +9998,7 @@ components:
           nullable: true
           type: string
         groups:
-          description: 'A list of (up to 20) monitor groups that narrow the scope
+          description: 'A list of (up to 100) monitor groups that narrow the scope
             of a monitor service level objective.
@@ -9630,7 +10017,7 @@ components:
             type: string
           type: array
         monitor_ids:
-          description: 'A list of monitor ids that defines the scope of a monitor
+          description: 'A list of monitor IDs that defines the scope of a monitor
             service level
             objective. **Required if type is `monitor`**.'
@@ -10135,6 +10522,7 @@ components:
       - locations
       - options
       - type
+      - message
       type: object
     SyntheticsAPITestConfig:
       description: Configuration object for a Synthetic API test.
@@ -10196,7 +10584,6 @@ components:
         responseHeaders:
           additionalProperties:
             description: Returned request header.
-            type: object
           description: Response headers returned for the API test.
           type: object
         responseSize:
@@ -10731,6 +11118,7 @@ components:
       - name
       - options
       - type
+      - message
       type: object
     SyntheticsBrowserTestConfig:
       description: Configuration object for a Synthetic browser test.
@@ -11228,12 +11616,12 @@ components:
       properties:
         cls:
           description: Cumulative Layout Shift.
-          format: int64
-          type: integer
+          format: double
+          type: number
         lcp:
           description: Largest Contentful Paint in milliseconds.
-          format: int64
-          type: integer
+          format: double
+          type: number
         url:
           description: URL attached to the metrics.
           type: string
@@ -11901,6 +12289,12 @@ components:
       - TYPE_TEXT
       - UPLOAD_FILES
       - WAIT
+    SyntheticsTestCiOptions:
+      description: CI/CD options for a Synthetic test.
+      properties:
+        executionRule:
+          $ref: '#/components/schemas/SyntheticsTestExecutionRule'
+      type: object
     SyntheticsTestConfig:
       description: Configuration object for a Synthetic test.
       properties:
@@ -12066,6 +12460,8 @@ components:
           description: For SSL test, whether or not the test should fail on revoked
             certificate in stapled OCSP.
           type: boolean
+        ci:
+          $ref: '#/components/schemas/SyntheticsTestCiOptions'
         device_ids:
           description: For browser test, array with the different device IDs used
             to run the test.
@@ -12863,7 +13259,9 @@ components:
       type: object
     TreeMapColorBy:
       default: user
-      description: The attribute used to determine color in the widget.
+      deprecated: true
+      description: (deprecated) The attribute formerly used to determine color in
+        the widget.
       enum:
       - user
       example: user
@@ -12871,7 +13269,9 @@ components:
       x-enum-varnames:
       - USER
     TreeMapGroupBy:
-      description: The attribute used to group elements in the widget.
+      deprecated: true
+      description: (deprecated) The attribute formerly used to group elements in the
+        widget.
       enum:
       - user
       - family
@@ -12883,7 +13283,9 @@ components:
       - FAMILY
       - PROCESS
     TreeMapSizeBy:
-      description: The attribute used to determine size in the widget.
+      deprecated: true
+      description: (deprecated) The attribute formerly used to determine size in the
+        widget.
       enum:
       - pct_cpu
       - pct_mem
@@ -12893,20 +13295,26 @@ components:
       - PCT_CPU
       - PCT_MEM
     TreeMapWidgetDefinition:
-      description: "The treemap visualization found on the Host Dashboards comes from
-        the output of `ps auxww`. This is not continuously run on your hosts. Instead,
-        it\u2019s run once on Agent start/restart. The treemap is only supported for
-        process data on a single host dashboard \u2014 this may not be reused in other
-        dashboards or for other metrics."
+      description: The treemap visualization enables you to display hierarchical and
+        nested data. It is well suited for queries that describe part-whole relationships,
+        such as resource usage by availability zone, data center, or team.
       properties:
         color_by:
           $ref: '#/components/schemas/TreeMapColorBy'
+        custom_links:
+          description: List of custom links.
+          items:
+            $ref: '#/components/schemas/WidgetCustomLink'
+          type: array
         group_by:
           $ref: '#/components/schemas/TreeMapGroupBy'
         requests:
-          description: List of top list widget requests.
+          description: List of treemap widget requests.
           example:
-          - q: system.load.1
+          - aggregator: sum
+            data_source: metrics
+            name: query1
+            query: sum:system.mem.total{*} by {service}
           items:
             $ref: '#/components/schemas/TreeMapWidgetRequest'
           maxItems: 1
@@ -12914,6 +13322,8 @@ components:
           type: array
         size_by:
           $ref: '#/components/schemas/TreeMapSizeBy'
+        time:
+          $ref: '#/components/schemas/WidgetTime'
         title:
           description: Title of your widget.
           type: string
@@ -13015,8 +13425,8 @@ components:
           type: string
         tag_config_source:
           description: The source of the usage attribution tag configuration and the
-            selected tags in the format `<source_org_name>:<selected tag 1>-<selected
-            tag 2>-<selected tag 3>`.
+            selected tags in the format `<source_org_name>:::<selected tag 1>///<selected
+            tag 2>///<selected tag 3>`.
           type: string
         tags:
           $ref: '#/components/schemas/UsageAttributionTagNames'
@@ -13086,6 +13496,8 @@ components:
       - snmp_usage
       - apm_host_usage
       - api_usage
+      - appsec_usage
+      - appsec_percentage
       - container_usage
       - custom_timeseries_percentage
       - container_percentage
@@ -13104,12 +13516,18 @@ components:
       - lambda_invocations_percentage
       - estimated_indexed_logs_usage
       - estimated_indexed_logs_percentage
+      - estimated_indexed_spans_usage
+      - estimated_indexed_spans_percentage
+      - estimated_ingested_spans_usage
+      - estimated_ingested_spans_percentage
       type: string
       x-enum-varnames:
       - API_PERCENTAGE
       - SNMP_USAGE
       - APM_HOST_USAGE
       - API_USAGE
+      - APPSEC_USAGE
+      - APPSEC_PERCENTAGE
       - CONTAINER_USAGE
       - CUSTOM_TIMESERIES_PERCENTAGE
       - CONTAINER_PERCENTAGE
@@ -13128,6 +13546,10 @@ components:
       - LAMBDA_INVOCATIONS_PERCENTAGE
       - ESTIMATED_INDEXED_LOGS_USAGE
       - ESTIMATED_INDEXED_LOGS_PERCENTAGE
+      - ESTIMATED_INDEXED_SPANS_USAGE
+      - ESTIMATED_INDEXED_SPANS_PERCENTAGE
+      - ESTIMATED_INGESTED_SPANS_USAGE
+      - ESTIMATED_INGESTED_SPANS_PERCENTAGE
     UsageAttributionSupportedMetrics:
       description: Supported fields for usage attribution requests (valid requests
         contain one or more metrics, or `*` for all).
@@ -13164,6 +13586,12 @@ components:
       - dbm_queries_percentage
       - estimated_indexed_logs_usage
       - estimated_indexed_logs_percentage
+      - appsec_usage
+      - appsec_percentage
+      - estimated_indexed_spans_usage
+      - estimated_indexed_spans_percentage
+      - estimated_ingested_spans_usage
+      - estimated_ingested_spans_percentage
       - '*'
       type: string
       x-enum-varnames:
@@ -13199,16 +13627,40 @@ components:
       - DBM_QUERIES_PERCENTAGE
       - ESTIMATED_INDEXED_LOGS_USAGE
       - ESTIMATED_INDEXED_LOGS_PERCENTAGE
+      - APPSEC_USAGE
+      - APPSEC_PERCENTAGE
+      - ESTIMATED_INDEXED_SPANS_USAGE
+      - ESTIMATED_INDEXED_SPANS_PERCENTAGE
+      - ESTIMATED_INGESTED_SPANS_USAGE
+      - ESTIMATED_INGESTED_SPANS_PERCENTAGE
       - ALL
     UsageAttributionTagNames:
       additionalProperties:
-        description: A list of tag values.
+        description: 'A list of values that are associated with each tag key.
+          - An empty list means the resource use wasn''t tagged with the respective
+          tag.
+          - Multiple values means the respective tag was applied multiple times on
+          the resource.
+          - An `<empty>` value means the resource was tagged with the respective tag
+          but did not have a value.'
         items:
           description: A given tag in a list.
           example: datadog-integrations-lab
           type: string
         type: array
-      description: Usage Summary by tag name.
+      description: 'Tag keys and values.
+        A `null` value here means that the requested tag breakdown cannot be applied
+        because it does not match the [tags
+        configured for usage attribution](https://docs.datadoghq.com/account_management/billing/usage_attribution/#getting-started).
+        In this scenario the API returns the total usage, not broken down by tags.'
       type: object
     UsageAttributionValues:
       description: Fields in Usage Summary by tag(s).
@@ -13229,6 +13681,15 @@ components:
           description: The APM host usage by tag(s).
           format: double
           type: number
+        appsec_percentage:
+          description: The percentage of Application Security Monitoring host usage
+            by tag(s).
+          format: double
+          type: number
+        appsec_usage:
+          description: The Application Security Monitoring host usage by tag(s).
+          format: double
+          type: number
         browser_percentage:
           description: The percentage of synthetic browser test usage by tag(s).
           format: double
@@ -13315,20 +13776,40 @@ components:
             field is in private beta.
           format: double
           type: number
-        infra_host_percentage:
-          description: The percentage of infrastructure host usage by tag(s).
+        estimated_indexed_spans_percentage:
+          description: The percentage of estimated indexed spans usage by tag(s).
+            Note this field is in private beta.
           format: double
           type: number
-        infra_host_usage:
-          description: The infrastructure host usage by tag(s).
+        estimated_indexed_spans_usage:
+          description: The estimated indexed spans usage by tag(s). Note this field
+            is in private beta.
           format: double
           type: number
-        lambda_functions_percentage:
-          description: The percentage of Lambda function usage by tag(s).
+        estimated_ingested_spans_percentage:
+          description: The percentage of estimated ingested spans usage by tag(s).
+            Note this field is in private beta.
           format: double
           type: number
-        lambda_functions_usage:
-          description: The Lambda function usage by tag(s).
+        estimated_ingested_spans_usage:
+          description: The estimated ingested spans usage by tag(s). Note this field
+            is in private beta.
+          format: double
+          type: number
+        infra_host_percentage:
+          description: The percentage of infrastructure host usage by tag(s).
+          format: double
+          type: number
+        infra_host_usage:
+          description: The infrastructure host usage by tag(s).
+          format: double
+          type: number
+        lambda_functions_percentage:
+          description: The percentage of Lambda function usage by tag(s).
+          format: double
+          type: number
+        lambda_functions_usage:
+          description: The Lambda function usage by tag(s).
           format: double
           type: number
         lambda_invocations_percentage:
@@ -13466,30 +13947,104 @@ components:
     UsageBillableSummaryKeys:
       description: Response with aggregated usage types.
       properties:
+        apm_fargate_average:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        apm_fargate_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         apm_host_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         apm_host_top99p:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        apm_profiler_host_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        apm_profiler_host_top99p:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         apm_trace_search_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        application_security_host_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        ci_pipeline_indexed_spans_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        ci_pipeline_maximum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        ci_pipeline_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        ci_test_indexed_spans_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        ci_testing_maximum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        ci_testing_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        cspm_container_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        cspm_host_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        cspm_host_top99p:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        custom_event_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        cws_container_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        cws_host_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        cws_host_top99p:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        dbm_host_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        dbm_host_top99p:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        dbm_normalized_queries_average:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        dbm_normalized_queries_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        fargate_container_apm_and_profiler_average:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        fargate_container_apm_and_profiler_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         fargate_container_average:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        fargate_container_profiler_average:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        fargate_container_profiler_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        fargate_container_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        incident_management_maximum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        incident_management_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        infra_and_apm_host_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        infra_and_apm_host_top99p:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         infra_container_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         infra_host_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         infra_host_top99p:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        ingested_spans_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        ingested_timeseries_average:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        ingested_timeseries_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        iot_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         iot_top99p:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         lambda_function_average:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        lambda_function_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         logs_indexed_15day_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         logs_indexed_180day_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         logs_indexed_30day_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        logs_indexed_360day_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         logs_indexed_3day_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         logs_indexed_45day_sum:
@@ -13506,6 +14061,8 @@ components:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         logs_ingested_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        network_device_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         network_device_top99p:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         npm_flow_sum:
@@ -13514,22 +14071,40 @@ components:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         npm_host_top99p:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        observability_pipeline_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        online_archive_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         prof_container_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        prof_host_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         prof_host_top99p:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        rum_lite_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        rum_replay_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         rum_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        rum_units_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
+        sensitive_data_scanner_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         serverless_invocation_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         siem_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        standard_timeseries_average:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
         synthetics_api_tests_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         synthetics_browser_checks_sum:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
         timeseries_average:
           $ref: '#/components/schemas/UsageBillableSummaryBody'
+        timeseries_sum:
+          $ref: '#/components/schemas/UsageBillableSummaryBody'
       type: object
     UsageBillableSummaryResponse:
       description: Response with monthly summary of data billed by Datadog.
@@ -16732,7 +17307,8 @@ components:
         authorizationCode:
           authorizationUrl: /oauth2/v1/authorize
           scopes:
-            dashboards_public_share: Share dashboards externally.
+            dashboards_public_share: Generate public and authenticated links to share
+              dashboards externally.
             dashboards_read: View dashboards.
             dashboards_write: Create and change dashboards.
             events_read: Read Events data.
@@ -16742,17 +17318,15 @@ components:
               downtimes.
             monitors_read: View monitors.
             monitors_write: Edit, mute, and delete individual monitors.
-            security_monitoring_signals_read: View Security Signals.
-            security_monitoring_signals_write: Modify Security Signals.
-            synthetics_global_variable_read: View, search, and use in tests the list
-              of global variables available for Synthetics.
+            synthetics_global_variable_read: View, search, and use Synthetics global
+              variables.
             synthetics_global_variable_write: Create, edit, and delete global variables
               for Synthetics.
-            synthetics_private_location_read: View, search, and use in tests the list
-              of available private locations.
+            synthetics_private_location_read: View, search, and use Synthetics private
+              locations.
             synthetics_private_location_write: Create and delete private locations
-              as well as seeing the associated installation guidelines.
-            synthetics_read: List and view configured Synthetic tests.
+              in addition to having access to the associated installation guidelines.
+            synthetics_read: List and view configured Synthetic tests and test results.
             synthetics_write: Create, edit, and delete Synthetic tests.
             timeseries_query: Query Timeseries data.
             usage_read: View your organization's usage and usage attribution.
@@ -17365,7 +17939,7 @@ paths:
       summary: Get the list of available daily custom reports
       tags:
       - Usage Metering
-      x-menu-order: 20
+      x-menu-order: 40
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -17416,7 +17990,7 @@ paths:
       summary: Get specified daily custom reports
       tags:
       - Usage Metering
-      x-menu-order: 21
+      x-menu-order: 41
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -18019,6 +18593,74 @@ paths:
       x-menu-order: 6
       x-undo:
         type: idempotent
+  /api/v1/distribution_points:
+    post:
+      description: "The distribution points end-point allows you to post distribution
+        data that can be graphed on Datadog\u2019s dashboards."
+      operationId: SubmitDistributionPoints
+      parameters:
+      - description: HTTP header used to compress the media-type.
+        in: header
+        name: Content-Encoding
+        required: false
+        schema:
+          $ref: '#/components/schemas/DistributionPointsContentEncoding'
+      requestBody:
+        content:
+          text/json:
+            examples:
+              dynamic-points:
+                description: "Post time-series data that can be graphed on Datadog\u2019s
+                  dashboards."
+                externalValue: examples/metrics/distribution-points.json.sh
+                summary: Dynamic Points
+                x-variables:
+                  NOW: $(date +%s)
+            schema:
+              $ref: '#/components/schemas/DistributionPointsPayload'
+        required: true
+      responses:
+        '202':
+          content:
+            text/json:
+              schema:
+                $ref: '#/components/schemas/IntakePayloadAccepted'
+          description: Payload accepted
+        '400':
+          content:
+            text/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            text/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication error
+        '408':
+          content:
+            text/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Request timeout
+        '413':
+          content:
+            text/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Payload too large
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+      summary: Submit distribution points
+      tags:
+      - Metrics
+      x-codegen-request-body-name: body
+      x-menu-order: 1
+      x-undo:
+        type: safe
   /api/v1/downtime:
     get:
       description: Get all scheduled downtimes.
@@ -18416,7 +19058,7 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - events_read
-      summary: Query the event stream
+      summary: Get a list of events
       tags:
       - Events
       x-menu-order: 1
@@ -18554,6 +19196,22 @@ paths:
         required: false
         schema:
           type: string
+      - description: The height of the graph. If no height is specified, the graph's
+          original height is used.
+        in: query
+        name: height
+        required: false
+        schema:
+          format: int64
+          type: integer
+      - description: The width of the graph. If no width is specified, the graph's
+          original width is used.
+        in: query
+        name: width
+        required: false
+        schema:
+          format: int64
+          type: integer
       responses:
         '200':
           content:
@@ -22537,7 +23195,7 @@ paths:
       summary: Get the list of available monthly custom reports
       tags:
       - Usage Metering
-      x-menu-order: 22
+      x-menu-order: 42
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -22594,7 +23252,7 @@ paths:
       summary: Get specified monthly custom reports
       tags:
       - Usage Metering
-      x-menu-order: 23
+      x-menu-order: 43
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -22988,7 +23646,7 @@ paths:
         type: idempotent
   /api/v1/org:
     get:
-      description: List your managed organizations.
+      description: This endpoint returns data on your top-level organization.
       operationId: ListOrgs
       responses:
         '200':
@@ -23151,6 +23809,47 @@ paths:
       x-menu-order: 4
       x-undo:
         type: idempotent
+  /api/v1/org/{public_id}/downgrade:
+    post:
+      description: Only available for MSP customers. Removes a child organization
+        from the hierarchy of the master organization and places the child organization
+        on a 30-day trial.
+      operationId: DowngradeOrg
+      parameters:
+      - description: The `public_id` of the organization you are operating within.
+        in: path
+        name: public_id
+        required: true
+        schema:
+          example: abc123
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OrgDowngradedResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Spin-off Child Organization
+      tags:
+      - Organizations
+      x-menu-order: 6
+      x-undo:
+        type: unsafe
   /api/v1/org/{public_id}/idp_metadata:
     post:
       description: 'There are a couple of options for updating the Identity Provider
@@ -23354,11 +24053,6 @@ paths:
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - AuthZ:
-        - security_monitoring_signals_write
-        apiKeyAuth: []
-        appKeyAuth: []
       summary: Add a security signal to an incident
       tags:
       - Security Monitoring
@@ -23405,11 +24099,6 @@ paths:
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - AuthZ:
-        - security_monitoring_signals_write
-        apiKeyAuth: []
-        appKeyAuth: []
       summary: Modify the triage assignee of a security signal
       tags:
       - Security Monitoring
@@ -23456,11 +24145,6 @@ paths:
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - AuthZ:
-        - security_monitoring_signals_write
-        apiKeyAuth: []
-        appKeyAuth: []
       summary: Change the triage state of a security signal
       tags:
       - Security Monitoring
@@ -23624,10 +24308,6 @@ paths:
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - apiKeyAuth: []
-        appKeyAuth: []
-      - AuthZ: []
       summary: Get all SLOs
       tags:
       - Service Level Objectives
@@ -23987,6 +24667,94 @@ paths:
       x-menu-order: 4
       x-undo:
         type: idempotent
+  /api/v1/slo/search:
+    get:
+      description: Get a list of service level objective objects for your organization.
+      operationId: SearchSLO
+      parameters:
+      - description: The query string to filter results based on SLO names.
+        in: query
+        name: query
+        required: false
+        schema:
+          type: string
+      - description: The number of files to return in the response `[default=10]`.
+        in: query
+        name: page[size]
+        required: false
+        schema:
+          format: int64
+          type: integer
+      - description: The identifier of the first page to return. This parameter is
+          used for the pagination feature `[default=0]`.
+        in: query
+        name: page[number]
+        required: false
+        schema:
+          format: int64
+          type: integer
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SearchSLOResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      servers:
+      - url: https://{subdomain}.{site}
+        variables:
+          site:
+            default: datadoghq.com
+            description: The regional site for Datadog customers.
+            enum:
+            - datadoghq.com
+            - us3.datadoghq.com
+            - us5.datadoghq.com
+            - ddog-gov.com
+          subdomain:
+            default: api
+            description: The subdomain where the API is deployed.
+      - url: '{protocol}://{name}'
+        variables:
+          name:
+            default: api.datadoghq.com
+            description: Full site DNS name.
+          protocol:
+            default: https
+            description: The protocol for accessing the API.
+      - url: https://{subdomain}.{site}
+        variables:
+          site:
+            default: datadoghq.com
+            description: Any Datadog deployment.
+          subdomain:
+            default: api
+            description: The subdomain where the API is deployed.
+      summary: Search for SLOs
+      tags:
+      - Service Level Objectives
+      x-menu-order: 1
+      x-undo:
+        type: safe
+      x-unstable: '**Note**: Note: This endpoint is in public beta for US regions.
+        It is not currently supported in the EU region.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v1/slo/{slo_id}:
     delete:
       description: 'Permanently delete the specified service level objective object.
@@ -24081,10 +24849,6 @@ paths:
           description: Not found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - apiKeyAuth: []
-        appKeyAuth: []
-      - AuthZ: []
       summary: Get an SLO's details
       tags:
       - Service Level Objectives
@@ -24180,10 +24944,6 @@ paths:
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - apiKeyAuth: []
-        appKeyAuth: []
-      - AuthZ: []
       summary: Get Corrections For an SLO
       tags:
       - Service Level Objectives
@@ -24268,10 +25028,6 @@ paths:
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      security:
-      - apiKeyAuth: []
-        appKeyAuth: []
-      - AuthZ: []
       summary: Get an SLO's history
       tags:
       - Service Level Objectives
@@ -25962,7 +26718,10 @@ paths:
         type: idempotent
   /api/v1/usage/analyzed_logs:
     get:
-      description: Get hourly usage for analyzed logs (Security Monitoring).
+      description: 'Get hourly usage for analyzed logs (Security Monitoring).
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageAnalyzedLogs
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26016,7 +26775,7 @@ paths:
       summary: Get hourly usage for analyzed logs
       tags:
       - Usage Metering
-      x-menu-order: 17
+      x-menu-order: 22
       x-undo:
         type: safe
   /api/v1/usage/attribution:
@@ -26108,7 +26867,7 @@ paths:
       summary: Get usage attribution
       tags:
       - Usage Metering
-      x-menu-order: 29
+      x-menu-order: 39
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -26116,7 +26875,10 @@ paths:
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v1/usage/audit_logs:
     get:
-      description: Get hourly usage for audit logs.
+      description: 'Get hourly usage for audit logs.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageAuditLogs
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26170,12 +26932,15 @@ paths:
       summary: Get hourly usage for audit logs
       tags:
       - Usage Metering
-      x-menu-order: 33
+      x-menu-order: 28
       x-undo:
         type: safe
   /api/v1/usage/aws_lambda:
     get:
-      description: Get hourly usage for lambda.
+      description: 'Get hourly usage for lambda.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageLambda
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -26224,10 +26989,10 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Lambda
+      summary: Get hourly usage for lambda
       tags:
       - Usage Metering
-      x-menu-order: 12
+      x-menu-order: 18
       x-undo:
         type: safe
   /api/v1/usage/billable-summary:
@@ -26276,12 +27041,15 @@ paths:
       summary: Get billable usage across your account
       tags:
       - Usage Metering
-      x-menu-order: 19
+      x-menu-order: 5
       x-undo:
         type: safe
   /api/v1/usage/ci-app:
     get:
-      description: Get hourly usage for CI Visibility (Tests, Pipeline, and Spans).
+      description: 'Get hourly usage for CI visibility (tests, pipeline, and spans).
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageCIApp
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26332,15 +27100,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for CI Visibility
+      summary: Get hourly usage for CI visibility
       tags:
       - Usage Metering
-      x-menu-order: 38
+      x-menu-order: 34
       x-undo:
         type: safe
   /api/v1/usage/cspm:
     get:
-      description: Get hourly usage for Cloud Security Posture Management (CSPM).
+      description: 'Get hourly usage for cloud security posture management (CSPM).
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageCloudSecurityPostureManagement
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26394,12 +27165,15 @@ paths:
       summary: Get hourly usage for CSPM
       tags:
       - Usage Metering
-      x-menu-order: 32
+      x-menu-order: 27
       x-undo:
         type: safe
   /api/v1/usage/cws:
     get:
-      description: Get hourly usage for Cloud Workload Security.
+      description: 'Get hourly usage for cloud workload security.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageCWS
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26450,15 +27224,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Cloud Workload Security
+      summary: Get hourly usage for cloud workload security
       tags:
       - Usage Metering
-      x-menu-order: 34
+      x-menu-order: 29
       x-undo:
         type: safe
   /api/v1/usage/dbm:
     get:
-      description: Get hourly usage for Database Monitoring
+      description: 'Get hourly usage for database monitoring
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageDBM
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26509,15 +27286,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Database Monitoring
+      summary: Get hourly usage for database monitoring
       tags:
       - Usage Metering
-      x-menu-order: 35
+      x-menu-order: 30
       x-undo:
         type: safe
   /api/v1/usage/fargate:
     get:
-      description: Get hourly usage for [Fargate](https://docs.datadoghq.com/integrations/ecs_fargate/).
+      description: 'Get hourly usage for [Fargate](https://docs.datadoghq.com/integrations/ecs_fargate/).
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageFargate
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -26569,12 +27349,15 @@ paths:
       summary: Get hourly usage for Fargate
       tags:
       - Usage Metering
-      x-menu-order: 11
+      x-menu-order: 17
       x-undo:
         type: safe
   /api/v1/usage/hosts:
     get:
-      description: Get hourly usage for hosts and containers.
+      description: 'Get hourly usage for hosts and containers.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageHosts
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -26626,7 +27409,7 @@ paths:
       summary: Get hourly usage for hosts and containers
       tags:
       - Usage Metering
-      x-menu-order: 1
+      x-menu-order: 10
       x-undo:
         type: safe
   /api/v1/usage/hourly-attribution:
@@ -26682,6 +27465,13 @@ paths:
         required: false
         schema:
           type: string
+      - description: Include child org usage in the response. Defaults to `true`.
+        in: query
+        name: include_descendants
+        required: false
+        schema:
+          default: true
+          type: boolean
       responses:
         '200':
           content:
@@ -26709,15 +27499,15 @@ paths:
       summary: Get hourly usage attribution
       tags:
       - Usage Metering
-      x-menu-order: 30
+      x-menu-order: 2
       x-undo:
         type: safe
-      x-unstable: '**Note**: This endpoint is in public beta.
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v1/usage/incident-management:
     get:
-      description: Get hourly usage for incident management.
+      description: 'Get hourly usage for incident management.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetIncidentManagement
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26771,12 +27561,15 @@ paths:
       summary: Get hourly usage for incident management
       tags:
       - Usage Metering
-      x-menu-order: 27
+      x-menu-order: 25
       x-undo:
         type: safe
   /api/v1/usage/indexed-spans:
     get:
-      description: Get hourly usage for indexed spans.
+      description: 'Get hourly usage for indexed spans.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageIndexedSpans
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26828,12 +27621,15 @@ paths:
       summary: Get hourly usage for indexed spans
       tags:
       - Usage Metering
-      x-menu-order: 7
+      x-menu-order: 13
       x-undo:
         type: safe
   /api/v1/usage/ingested-spans:
     get:
-      description: Get hourly usage for ingested spans.
+      description: 'Get hourly usage for ingested spans.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetIngestedSpans
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26887,12 +27683,15 @@ paths:
       summary: Get hourly usage for ingested spans
       tags:
       - Usage Metering
-      x-menu-order: 26
+      x-menu-order: 24
       x-undo:
         type: safe
   /api/v1/usage/iot:
     get:
-      description: Get hourly usage for IoT.
+      description: 'Get hourly usage for IoT.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageInternetOfThings
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -26946,12 +27745,15 @@ paths:
       summary: Get hourly usage for IoT
       tags:
       - Usage Metering
-      x-menu-order: 28
+      x-menu-order: 26
       x-undo:
         type: safe
   /api/v1/usage/logs:
     get:
-      description: Get hourly usage for logs.
+      description: 'Get hourly usage for logs.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageLogs
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -27000,15 +27802,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Logs
+      summary: Get hourly usage for logs
       tags:
       - Usage Metering
-      x-menu-order: 2
+      x-menu-order: 11
       x-undo:
         type: safe
   /api/v1/usage/logs-by-retention:
     get:
-      description: Get hourly usage for indexed logs by retention period.
+      description: 'Get hourly usage for indexed logs by retention period.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageLogsByRetention
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27062,6 +27867,7 @@ paths:
       summary: Get hourly logs usage by retention
       tags:
       - Usage Metering
+      x-menu-order: 9
       x-undo:
         type: safe
   /api/v1/usage/logs_by_index:
@@ -27123,10 +27929,10 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Logs by Index
+      summary: Get hourly usage for logs by index
       tags:
       - Usage Metering
-      x-menu-order: 3
+      x-menu-order: 8
       x-undo:
         type: safe
   /api/v1/usage/monthly-attribution:
@@ -27195,6 +28001,13 @@ paths:
         required: false
         schema:
           type: string
+      - description: Include child org usage in the response. Defaults to `true`.
+        in: query
+        name: include_descendants
+        required: false
+        schema:
+          default: true
+          type: boolean
       responses:
         '200':
           content:
@@ -27230,15 +28043,15 @@ paths:
           - name: fields
             value: '"infra_host_usage"'
           step: there is a valid "monthly_usage_attribution" response
-      x-menu-order: 31
+      x-menu-order: 3
       x-undo:
         type: safe
-      x-unstable: '**Note**: This endpoint is in public beta.
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v1/usage/network_flows:
     get:
-      description: Get hourly usage for network flows.
+      description: 'Get hourly usage for network flows.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageNetworkFlows
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27289,15 +28102,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Network Flows
+      summary: get hourly usage for network flows
       tags:
       - Usage Metering
-      x-menu-order: 15
+      x-menu-order: 21
       x-undo:
         type: safe
   /api/v1/usage/network_hosts:
     get:
-      description: Get hourly usage for network hosts.
+      description: 'Get hourly usage for network hosts.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageNetworkHosts
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -27346,15 +28162,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Network Hosts
+      summary: Get hourly usage for network hosts
       tags:
       - Usage Metering
-      x-menu-order: 14
+      x-menu-order: 20
       x-undo:
         type: safe
   /api/v1/usage/online-archive:
     get:
-      description: Get hourly usage for Online Archive.
+      description: 'Get hourly usage for online archive.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageOnlineArchive
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27405,15 +28224,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Online Archive
+      summary: Get hourly usage for online archive
       tags:
       - Usage Metering
-      x-menu-order: 38
+      x-menu-order: 35
       x-undo:
         type: safe
   /api/v1/usage/profiling:
     get:
-      description: Get hourly usage for profiled hosts.
+      description: 'Get hourly usage for profiled hosts.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageProfiling
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27467,13 +28289,16 @@ paths:
       summary: Get hourly usage for profiled hosts
       tags:
       - Usage Metering
-      x-menu-order: 24
+      x-menu-order: 33
       x-undo:
         type: safe
   /api/v1/usage/rum:
     get:
-      description: Get hourly usage for [RUM](https://docs.datadoghq.com/real_user_monitoring/)
+      description: 'Get hourly usage for [RUM](https://docs.datadoghq.com/real_user_monitoring/)
         Units.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageRumUnits
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -27522,16 +28347,19 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for RUM Units
+      summary: Get hourly usage for RUM units
       tags:
       - Usage Metering
-      x-menu-order: 37
+      x-menu-order: 32
       x-undo:
         type: safe
   /api/v1/usage/rum_sessions:
     get:
-      description: Get hourly usage for [RUM](https://docs.datadoghq.com/real_user_monitoring/)
+      description: 'Get hourly usage for [RUM](https://docs.datadoghq.com/real_user_monitoring/)
         Sessions.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageRumSessions
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -27586,15 +28414,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for RUM Sessions
+      summary: Get hourly usage for RUM sessions
       tags:
       - Usage Metering
-      x-menu-order: 13
+      x-menu-order: 19
       x-undo:
         type: safe
   /api/v1/usage/sds:
     get:
-      description: Get hourly usage for Sensitive Data Scanner.
+      description: 'Get hourly usage for sensitive data scanner.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageSDS
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27645,15 +28476,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Sensitive Data Scanner
+      summary: Get hourly usage for sensitive data scanner
       tags:
       - Usage Metering
-      x-menu-order: 36
+      x-menu-order: 31
       x-undo:
         type: safe
   /api/v1/usage/snmp:
     get:
-      description: Get hourly usage for SNMP devices.
+      description: 'Get hourly usage for SNMP devices.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageSNMP
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
@@ -27707,7 +28541,7 @@ paths:
       summary: Get hourly usage for SNMP devices
       tags:
       - Usage Metering
-      x-menu-order: 18
+      x-menu-order: 23
       x-undo:
         type: safe
   /api/v1/usage/summary:
@@ -27773,13 +28607,16 @@ paths:
       summary: Get usage across your multi-org account
       tags:
       - Usage Metering
-      x-menu-order: 16
+      x-menu-order: 7
       x-undo:
         type: safe
   /api/v1/usage/synthetics:
     get:
       deprecated: true
-      description: Get hourly usage for [Synthetics checks](https://docs.datadoghq.com/synthetics/).
+      description: 'Get hourly usage for [synthetics checks](https://docs.datadoghq.com/synthetics/).
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageSynthetics
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -27828,15 +28665,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Synthetics Checks
+      summary: Get hourly usage for synthetics checks
       tags:
       - Usage Metering
-      x-menu-order: 8
+      x-menu-order: 14
       x-undo:
         type: safe
   /api/v1/usage/synthetics_api:
     get:
-      description: Get hourly usage for [synthetics API checks](https://docs.datadoghq.com/synthetics/).
+      description: 'Get hourly usage for [synthetics API checks](https://docs.datadoghq.com/synthetics/).
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageSyntheticsAPI
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -27885,15 +28725,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Synthetics API Checks
+      summary: Get hourly usage for synthetics API checks
       tags:
       - Usage Metering
-      x-menu-order: 9
+      x-menu-order: 15
       x-undo:
         type: safe
   /api/v1/usage/synthetics_browser:
     get:
-      description: Get hourly usage for synthetics browser checks.
+      description: 'Get hourly usage for synthetics browser checks.
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageSyntheticsBrowser
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -27942,15 +28785,18 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - usage_read
-      summary: Get hourly usage for Synthetics Browser Checks
+      summary: Get hourly usage for synthetics browser checks
       tags:
       - Usage Metering
-      x-menu-order: 10
+      x-menu-order: 16
       x-undo:
         type: safe
   /api/v1/usage/timeseries:
     get:
-      description: Get hourly usage for [custom metrics](https://docs.datadoghq.com/developers/metrics/custom_metrics/).
+      description: 'Get hourly usage for [custom metrics](https://docs.datadoghq.com/developers/metrics/custom_metrics/).
+        **Note:** hourly usage data for all products is now available in the [Get
+        hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family)'
       operationId: GetUsageTimeseries
       parameters:
       - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh]
@@ -28002,7 +28848,7 @@ paths:
       summary: Get hourly usage for custom metrics
       tags:
       - Usage Metering
-      x-menu-order: 4
+      x-menu-order: 12
       x-undo:
         type: safe
   /api/v1/usage/top_avg_metrics:
@@ -28088,7 +28934,7 @@ paths:
       summary: Get all custom metrics by hourly average
       tags:
       - Usage Metering
-      x-menu-order: 5
+      x-menu-order: 6
       x-undo:
         type: safe
   /api/v1/user:
@@ -28610,9 +29456,11 @@ tags:
     event stream
     and fetch events from the event stream. Events are limited to 4000 characters.
-    If an event is sent out with a message
-    containing more than 4000 characters only the 4000 first characters are displayed.'
+    If an event is sent out with a message containing more than 4000 characters, only
+    the
+    first 4000 characters are displayed.'
   name: Events
 - description: 'Configure your Datadog-Google Cloud Platform (GCP) integration directly
@@ -28697,11 +29545,11 @@ tags:
     description: Find out more at
     url: https://docs.datadoghq.com/account_management/multi_organization
   name: Organizations
-- description: 'Configure your [Datadog-PagerDuty integration](https://docs.datadoghq.com/api/?lang=bash#integration-pagerduty)
+- description: 'Configure your [Datadog-PagerDuty integration](https://docs.datadoghq.com/integrations/pagerduty/)
     directly through the Datadog API.'
   externalDocs:
-    url: https://docs.datadoghq.com/api/?lang=bash#integration-pagerduty
+    url: https://docs.datadoghq.com/integrations/pagerduty/
   name: PagerDuty Integration
 - description: 'Detection rules for generating signals and listing of generated