datadog_api_client 1.0.0.beta.3 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e534fca19317ca0ba95ec43ff872abab759c5fd8755f89c51b6dc46e0873e1cb
-  data.tar.gz: 7ead603a0d072967f5ba2d45827d1e391575543aac698bf2997d6e8730aa1b8e
+  metadata.gz: 6f8c27f68745fac84ba1e99c2eb2a3b8c5069c9f9eebb75e1613f17c46b881e7
+  data.tar.gz: f76092cc4feefa6da4c37a5fe6518d7f2e43d0f80a3acbf0498f2a2605150052
 SHA512:
-  metadata.gz: f85d8c2b2073449c0407c7f0cb8f5735e9c3a4d95a0bfbdb3d6883aa9dc150471e917f9ad2247e4dae0ac42caaaaa1ffe94ad641ce3ec90dca1c2c4e2edcb4eb
-  data.tar.gz: 6aab6c05bca44e03686bb28f54e30daf0cea91955b5b39474a321c78f211d9ae3b9cb11ff2081447cd66b25b68527f0f6d9132eaa8023d26586cffc4d5acf2c9
+  metadata.gz: 5d8522e5a486a3fec4475bed5df0d9fd60a5140d36c8bde7e08680b8948de228504ee9bb85ee753b5629b991ec296dc6cbff0cbff505f3cc7480d6146bee9f77
+  data.tar.gz: d391296273c9822018604c15266617d55ced689c4fe863f1b16eff624c76b48f4dc77c788d2e5c137b4e205a5a4f32a13166fad57da4c1c267105c5b4db3c15e

data/.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.4.1.dev6",
-            "regenerated": "2021-04-14 13:00:19.157663",
-            "spec_repo_commit": "f1b60ce"
+            "regenerated": "2021-05-12 09:43:20.279249",
+            "spec_repo_commit": "62c8ffe"
         },
         "v2": {
             "apigentools_version": "1.4.1.dev6",
-            "regenerated": "2021-04-14 13:00:32.499210",
-            "spec_repo_commit": "f1b60ce"
+            "regenerated": "2021-05-12 09:44:17.148819",
+            "spec_repo_commit": "62c8ffe"
         }
     }
 }

data/.azure-pipelines/all.yml

@@ -48,4 +48,3 @@ jobs:
         DD_TEST_CLIENT_APP_KEY: $(datadogAPPKey)
         DD_TRACE_ANALYTICS_ENABLED: "true"
         RECORD: "none"
-        CODECOV_TOKEN: $(codecovToken)

data/.rubocop.yml

@@ -1,7 +1,7 @@
 # This file is based on https://github.com/rails/rails/blob/master/.rubocop.yml (MIT license)
 # Automatically generated by OpenAPI Generator (https://openapi-generator.tech)
 AllCops:
-  TargetRubyVersion: 2.4
+  TargetRubyVersion: 2.5
   # RuboCop has a bunch of cops enabled by default. This setting tells RuboCop
   # to ignore them, so only the ones explicitly set in this file are enabled.
   DisabledByDefault: true

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # CHANGELOG
 
+## 1.0.0 / 2021-05-12
+
+* [Added] Notebooks Public API Documentation. See [#351](https://github.com/DataDog/datadog-api-client-ruby/pull/351).
+* [Added] Add `logs_by_retention` usage property and `GetUsageLogsByRetention` endpoint. See [#345](https://github.com/DataDog/datadog-api-client-ruby/pull/345).
+* [Added] Add anomaly detection method to `SecurityMonitoringRuleDetectionMethod` enum. See [#344](https://github.com/DataDog/datadog-api-client-ruby/pull/344).
+* [Added] Add `with_configured_alert_ids` parameter to get a SLO details endpoint. See [#341](https://github.com/DataDog/datadog-api-client-ruby/pull/341).
+* [Added] Add `setCookie`, `dnsServerPort`,  `allowFailure ` and `isCritical` fields for Synthetics tests. See [#338](https://github.com/DataDog/datadog-api-client-ruby/pull/338).
+* [Added] Add `metadata` property with pagination info to `SLOList` endpoint response. See [#334](https://github.com/DataDog/datadog-api-client-ruby/pull/334).
+* [Added] Add new properties to group widget, note widget and image widget. See [#331](https://github.com/DataDog/datadog-api-client-ruby/pull/331).
+* [Added] Add support for a `rate` metric type in manage metric tags v2 endpoint. See [#329](https://github.com/DataDog/datadog-api-client-ruby/pull/329).
+* [Added] Add support for ICMP Synthetics tests. See [#326](https://github.com/DataDog/datadog-api-client-ruby/pull/326).
+* [Added] Add vSphere usage information. See [#323](https://github.com/DataDog/datadog-api-client-ruby/pull/323).
+* [Added] Mark metric volumes and ingested tags endpoints as stable. See [#318](https://github.com/DataDog/datadog-api-client-ruby/pull/318).
+* [Added] Add `filter[shared]` query parameter for searching dashboards. See [#310](https://github.com/DataDog/datadog-api-client-ruby/pull/310).
+* [Added] Add profiling product fields in usage metering endpoint. See [#309](https://github.com/DataDog/datadog-api-client-ruby/pull/309).
+* [Added] Add `title` and `background_color` properties to dashboard group widget. See [#308](https://github.com/DataDog/datadog-api-client-ruby/pull/308).
+* [Added] Add `marker`, `xaxis` and `yaxis` properties on distribution widgets. See [#322](https://github.com/DataDog/datadog-api-client-ruby/pull/322).
+* [Fixed] Remove default value of `is_column_break` layout property of dashboard. See [#350](https://github.com/DataDog/datadog-api-client-ruby/pull/350).
+* [Changed] Enumerate accepted values for fields parameter in usage attribution requests. See [#348](https://github.com/DataDog/datadog-api-client-ruby/pull/348).
+* [Changed] Add frequency and remove request as required field from synthetics test. See [#346](https://github.com/DataDog/datadog-api-client-ruby/pull/346).
+* [Deprecated] Deprecate `legend_size` and `show_legend` properties on distribution widgets. See [#322](https://github.com/DataDog/datadog-api-client-ruby/pull/322).
+* [Removed] Remove deprecated Synthetics methods `CreateTest` and `UpdateTest`. See [#324](https://github.com/DataDog/datadog-api-client-ruby/pull/324).
+
 ## v1.0.0.beta.3 / 2021-04-15
 
 * [Added] Add `reflow_type` property to dashboard object. See [#294](https://github.com/DataDog/datadog-api-client-ruby/pull/294).

data/Gemfile

@@ -5,7 +5,6 @@ source 'https://rubygems.org'
 gemspec
 
 group :development, :test do
-  gem 'codecov', '!= 0.2.14'
   gem 'cucumber'
   gem 'gem-release'
   # gem 'ddtrace'
@@ -16,6 +15,7 @@ group :development, :test do
   gem 'rubocop'
   gem 'reek'
   gem 'rspec-expectations'
+  gem 'simplecov'
   gem 'solargraph'
   gem 'timecop'
   gem 'webmock'

data/LICENSE-3rdparty.csv

@@ -7,7 +7,6 @@ benchmark,BSD-2-Clause,Yukihiro Matsumoto
 builder,MIT,Jim Weirich
 bundler,MIT,"André Arko, Samuel Giddins, Colby Swandale, Hiroshi Shibata, David Rodríguez, Grey Baker, Stephanie Morillo, Chris Morris, James Wen, Tim Moore, André Medeiros, Jessica Lynn Suttles, Terence Lee, Carl Lerche, Yehuda Katz"
 byebug,BSD-2-Clause,"David Rodriguez, Kent Sibilev, Mark Moseley"
-codecov,MIT,codecov
 coderay,MIT,Kornelius Kalnbach
 concurrent-ruby,MIT,"Jerry D'Antonio, Petr Chalupa, The Ruby Concurrency Team"
 crack,MIT,John Nunemaker

data/check-examples.sh

@@ -1,9 +1,14 @@
 #!/usr/bin/env bash
 
-./extract-code-blocks.sh
+if [ $# -eq 0 ]; then
+    echo "No arguments supplied"
+    exit 2
+fi
+
+./extract-code-blocks.sh examples $1
 
 bundle install
-ls examples/v*/*/*.rbbeta | xargs -P $(($(nproc)*2)) -n 1 bundle exec ruby -cw && bundle exec rubocop examples/v*/*/*.rbbeta
+ls examples/$1/*/*.rbbeta | xargs -P $(($(nproc)*2)) -n 1 bundle exec ruby -cw && bundle exec rubocop examples/$1/*/*.rbbeta
 if [ $? -ne 0 ]; then
     echo -e "Failed to build examples"
     exit 1

data/data/v1/openapi.yaml

@@ -1005,10 +1005,10 @@ components:
           type: array
       type: object
     DashboardReflowType:
-      description: 'Reflow type for a multi-size layout dashboard. Set this only when
-        layout type is ''ordered''.
+      description: 'Reflow type for a **new dashboard layout** dashboard. Set this
+        only when layout type is ''ordered''.
 
-        If set to ''fixed'', the dashboard expect all widgets to have a layout, and
+        If set to ''fixed'', the dashboard expects all widgets to have a layout, and
         if it''s set to ''auto'',
 
         widgets should not have layouts.'
@@ -1119,7 +1119,15 @@ components:
         \ a distribution graph\u2019s x-axis is quantity rather than time."
       properties:
         legend_size:
-          $ref: '#/components/schemas/WidgetLegendSize'
+          deprecated: true
+          description: (Deprecated) The widget legend was replaced by a tooltip and
+            sidebar.
+          type: string
+        markers:
+          description: List of markers.
+          items:
+            $ref: '#/components/schemas/WidgetMarker'
+          type: array
         requests:
           description: "Array of one request object to display in the widget.\n\n\
             See the dedicated [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json)\n\
@@ -1132,7 +1140,9 @@ components:
           minItems: 1
           type: array
         show_legend:
-          description: Whether or not to display the legend on this widget.
+          deprecated: true
+          description: (Deprecated) The widget legend was replaced by a tooltip and
+            sidebar.
           type: boolean
         time:
           $ref: '#/components/schemas/WidgetTime'
@@ -1146,6 +1156,10 @@ components:
           type: string
         type:
           $ref: '#/components/schemas/DistributionWidgetDefinitionType'
+        xaxis:
+          $ref: '#/components/schemas/DistributionWidgetXAxis'
+        yaxis:
+          $ref: '#/components/schemas/DistributionWidgetYAxis'
       required:
       - type
       - requests
@@ -1184,6 +1198,51 @@ components:
         style:
           $ref: '#/components/schemas/WidgetStyle'
       type: object
+    DistributionWidgetXAxis:
+      description: X Axis controls for the distribution widget.
+      properties:
+        include_zero:
+          description: True includes zero.
+          type: boolean
+        max:
+          default: auto
+          description: Specifies maximum value to show on the x-axis. It takes a number,
+            percentile (p90 === 90th percentile), or auto for default behavior.
+          type: string
+        min:
+          default: auto
+          description: Specifies minimum value to show on the x-axis. It takes a number,
+            percentile (p90 === 90th percentile), or auto for default behavior.
+          type: string
+        scale:
+          default: linear
+          description: Specifies the scale type. Possible values are `linear`.
+          type: string
+      type: object
+    DistributionWidgetYAxis:
+      description: Y Axis controls for the distribution widget.
+      properties:
+        include_zero:
+          description: True includes zero.
+          type: boolean
+        label:
+          description: The label of the axis to display on the graph.
+          type: string
+        max:
+          default: auto
+          description: Specifies the maximum value to show on the y-axis. It takes
+            a number, or auto for default behavior.
+          type: string
+        min:
+          default: auto
+          description: Specifies minimum value to show on the y-axis. It takes a number,
+            or auto for default behavior.
+          type: string
+        scale:
+          default: linear
+          description: Specifies the scale type. Possible values are `linear` or `log`.
+          type: string
+      type: object
     Downtime:
       description: 'Downtiming gives you greater control over monitor notifications
         by
@@ -2242,11 +2301,23 @@ components:
         your timeboard. Each group has a custom header, can hold one to many graphs,
         and is collapsible.
       properties:
+        background_color:
+          description: Background color of the group title.
+          type: string
+        banner_img:
+          description: URL of image to display as a banner for the group.
+          type: string
         layout_type:
           $ref: '#/components/schemas/WidgetLayoutType'
+        show_title:
+          default: true
+          description: Whether to show the title or not.
+          type: boolean
         title:
           description: Title of the widget.
           type: string
+        title_align:
+          $ref: '#/components/schemas/WidgetTextAlign'
         type:
           $ref: '#/components/schemas/GroupWidgetDefinitionType'
         widgets:
@@ -2936,6 +3007,18 @@ components:
         An image can be a PNG, JPG, or animated GIF. Only available on FREE layout
         dashboards.
       properties:
+        has_background:
+          default: true
+          description: Whether to display a background or not.
+          example: true
+          type: boolean
+        has_border:
+          default: true
+          description: Whether to display a border or not.
+          example: true
+          type: boolean
+        horizontal_align:
+          $ref: '#/components/schemas/WidgetHorizontalAlign'
         margin:
           $ref: '#/components/schemas/WidgetMargin'
         sizing:
@@ -2944,8 +3027,14 @@ components:
           $ref: '#/components/schemas/ImageWidgetDefinitionType'
         url:
           description: URL of the image.
-          example: ''
+          example: https://example.com/image.png
+          type: string
+        url_dark_theme:
+          description: URL of the image in dark mode.
+          example: https://example.com/image-dark-mode.png
           type: string
+        vertical_align:
+          $ref: '#/components/schemas/WidgetVerticalAlign'
       required:
       - type
       - url
@@ -3293,6 +3382,51 @@ components:
       type: string
       x-enum-varnames:
       - ATTRIBUTE_REMAPPER
+    LogsByRetention:
+      description: Object containing logs usage data broken down by retention period.
+      properties:
+        orgs:
+          description: Indexed logs usage summary for each organization for each retention
+            period with usage.
+          properties:
+            usage:
+              description: Indexed logs usage summary for each organization.
+              items:
+                $ref: '#/components/schemas/LogsByRetentionOrgUsage'
+              type: array
+          type: object
+        usage:
+          description: Aggregated index logs usage for each retention period with
+            usage.
+          items:
+            $ref: '#/components/schemas/LogsRetentionAggSumUsage'
+          type: array
+        usage_by_month:
+          $ref: '#/components/schemas/LogsByRetentionMonthlyUsage'
+      type: object
+    LogsByRetentionMonthlyUsage:
+      description: Object containing a summary of indexed logs usage by retention
+        period for a single month.
+      properties:
+        date:
+          description: The month for the usage.
+          format: datetime
+          type: string
+        usage:
+          description: Indexed logs usage for each active retention for the month.
+          items:
+            $ref: '#/components/schemas/LogsRetentionSumUsage'
+          type: array
+      type: object
+    LogsByRetentionOrgUsage:
+      description: Indexed logs usage by retention for a single organization.
+      properties:
+        usage:
+          description: Indexed logs usage for each active retention for the organization.
+          items:
+            $ref: '#/components/schemas/LogsRetentionSumUsage'
+          type: array
+      type: object
     LogsCategoryProcessor:
       description: "Use the Category Processor to add a new attribute (without spaces\
         \ or special characters in the new attribute name)\nto a log matching a provided\
@@ -4009,6 +4143,48 @@ components:
       required:
       - aggregation
       type: object
+    LogsRetentionAggSumUsage:
+      description: Object containing indexed logs usage aggregated across organizations
+        and months for a retention period.
+      properties:
+        logs_indexed_logs_usage_agg_sum:
+          description: Total indexed logs for this retention period.
+          format: int64
+          type: integer
+        logs_live_indexed_logs_usage_agg_sum:
+          description: Live indexed logs for this retention period.
+          format: int64
+          type: integer
+        logs_rehydrated_indexed_logs_usage_agg_sum:
+          description: Rehydrated indexed logs for this retention period.
+          format: int64
+          type: integer
+        retention:
+          description: The retention period in days or "custom" for all custom retention
+            periods.
+          type: string
+      type: object
+    LogsRetentionSumUsage:
+      description: Object containing indexed logs usage grouped by retention period
+        and summed.
+      properties:
+        logs_indexed_logs_usage_sum:
+          description: Total indexed logs for this retention period.
+          format: int64
+          type: integer
+        logs_live_indexed_logs_usage_sum:
+          description: Live indexed logs for this retention period.
+          format: int64
+          type: integer
+        logs_rehydrated_indexed_logs_usage_sum:
+          description: Rehydrated indexed logs for this retention period.
+          format: int64
+          type: integer
+        retention:
+          description: The retention period in days or "custom" for all custom retention
+            periods.
+          type: string
+      type: object
     LogsServiceRemapper:
       description: 'Use this processor if you want to assign one or more attributes
         as the official service.
@@ -5024,51 +5200,712 @@ components:
         tags:
           description: Tags associated to your monitor.
           items:
-            description: A Datadog tag.
-            type: string
+            description: A Datadog tag.
+            type: string
+          type: array
+        type:
+          $ref: '#/components/schemas/MonitorType'
+      type: object
+    NoteWidgetDefinition:
+      description: The notes and links widget is similar to free text widget, but
+        allows for more formatting options.
+      properties:
+        background_color:
+          description: Background color of the note.
+          type: string
+        content:
+          description: Content of the note.
+          example: ''
+          type: string
+        font_size:
+          description: Size of the text.
+          type: string
+        has_padding:
+          default: true
+          description: Whether to add padding or not.
+          type: boolean
+        show_tick:
+          description: Whether to show a tick or not.
+          type: boolean
+        text_align:
+          $ref: '#/components/schemas/WidgetTextAlign'
+        tick_edge:
+          $ref: '#/components/schemas/WidgetTickEdge'
+        tick_pos:
+          description: Where to position the tick on an edge.
+          type: string
+        type:
+          $ref: '#/components/schemas/NoteWidgetDefinitionType'
+        vertical_align:
+          $ref: '#/components/schemas/WidgetVerticalAlign'
+      required:
+      - type
+      - content
+      type: object
+    NoteWidgetDefinitionType:
+      default: note
+      description: Type of the note widget.
+      enum:
+      - note
+      example: note
+      type: string
+      x-enum-varnames:
+      - NOTE
+    NotebookAbsoluteTime:
+      description: Absolute timeframe.
+      example:
+        end: '2021-02-24T20:18:28+00:00'
+        start: '2021-02-24T19:18:28+00:00'
+      properties:
+        end:
+          description: The end time.
+          example: '2021-02-24T20:18:28+00:00'
+          format: date-time
+          type: string
+        live:
+          description: Indicates whether the timeframe should be shifted to end at
+            the current time.
+          type: boolean
+        start:
+          description: The start time.
+          example: '2021-02-24T19:18:28+00:00'
+          format: date-time
+          type: string
+      required:
+      - start
+      - end
+    NotebookAuthor:
+      description: Attributes of user object returned by the API.
+      properties:
+        created_at:
+          description: Creation time of the user.
+          format: date-time
+          type: string
+        disabled:
+          description: Whether the user is disabled.
+          type: boolean
+        email:
+          description: Email of the user.
+          type: string
+        handle:
+          description: Handle of the user.
+          type: string
+        icon:
+          description: URL of the user's icon.
+          type: string
+        name:
+          description: Name of the user.
+          type: string
+        status:
+          description: Status of the user.
+          type: string
+        title:
+          description: Title of the user.
+          type: string
+        verified:
+          description: Whether the user is verified.
+          type: boolean
+      type: object
+    NotebookCellCreateRequest:
+      description: The description of a notebook cell create request.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/NotebookCellCreateRequestAttributes'
+        type:
+          $ref: '#/components/schemas/NotebookCellResourceType'
+      required:
+      - attributes
+      - type
+      type: object
+    NotebookCellCreateRequestAttributes:
+      description: 'The attributes of a notebook cell in create cell request. Valid
+        cell types are `markdown`, `timeseries`, `toplist`, `heatmap`, `distribution`,
+
+        `log_stream`. [More information on each graph visualization type.](https://docs.datadoghq.com/dashboards/widgets/)'
+      example:
+        definition:
+          requests:
+          - display_type: line
+            q: avg:system.load.1{*}
+            style:
+              line_type: solid
+              line_width: normal
+              palette: dog_classic
+          show_legend: true
+          type: timeseries
+          yaxis:
+            scale: linear
+        graph_size: m
+        split_by:
+          keys: []
+          tags: []
+        time: null
+      oneOf:
+      - $ref: '#/components/schemas/NotebookMarkdownCellAttributes'
+      - $ref: '#/components/schemas/NotebookTimeseriesCellAttributes'
+      - $ref: '#/components/schemas/NotebookToplistCellAttributes'
+      - $ref: '#/components/schemas/NotebookHeatMapCellAttributes'
+      - $ref: '#/components/schemas/NotebookDistributionCellAttributes'
+      - $ref: '#/components/schemas/NotebookLogStreamCellAttributes'
+      type: object
+    NotebookCellResourceType:
+      default: notebook_cells
+      description: Type of the Notebook Cell resource.
+      enum:
+      - notebook_cells
+      example: notebook_cells
+      type: string
+      x-enum-varnames:
+      - NOTEBOOK_CELLS
+    NotebookCellResponse:
+      description: The description of a notebook cell response.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/NotebookCellResponseAttributes'
+        id:
+          description: Notebook cell ID.
+          example: abcd1234
+          type: string
+        type:
+          $ref: '#/components/schemas/NotebookCellResourceType'
+      required:
+      - id
+      - type
+      - attributes
+      type: object
+    NotebookCellResponseAttributes:
+      description: 'The attributes of a notebook cell response. Valid cell types are
+        `markdown`, `timeseries`, `toplist`, `heatmap`, `distribution`,
+
+        `log_stream`. [More information on each graph visualization type.](https://docs.datadoghq.com/dashboards/widgets/)'
+      oneOf:
+      - $ref: '#/components/schemas/NotebookMarkdownCellAttributes'
+      - $ref: '#/components/schemas/NotebookTimeseriesCellAttributes'
+      - $ref: '#/components/schemas/NotebookToplistCellAttributes'
+      - $ref: '#/components/schemas/NotebookHeatMapCellAttributes'
+      - $ref: '#/components/schemas/NotebookDistributionCellAttributes'
+      - $ref: '#/components/schemas/NotebookLogStreamCellAttributes'
+      type: object
+    NotebookCellTime:
+      description: Timeframe for the notebook cell. When 'null', the notebook global
+        time is used.
+      nullable: true
+      oneOf:
+      - $ref: '#/components/schemas/NotebookRelativeTime'
+      - $ref: '#/components/schemas/NotebookAbsoluteTime'
+      type: object
+    NotebookCellUpdateRequest:
+      description: The description of a notebook cell update request.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/NotebookCellUpdateRequestAttributes'
+        id:
+          description: Notebook cell ID.
+          example: abcd1234
+          type: string
+        type:
+          $ref: '#/components/schemas/NotebookCellResourceType'
+      required:
+      - id
+      - type
+      - attributes
+      type: object
+    NotebookCellUpdateRequestAttributes:
+      description: 'The attributes of a notebook cell in update cell request. Valid
+        cell types are `markdown`, `timeseries`, `toplist`, `heatmap`, `distribution`,
+
+        `log_stream`. [More information on each graph visualization type.](https://docs.datadoghq.com/dashboards/widgets/)'
+      example:
+        definition:
+          requests:
+          - display_type: line
+            q: avg:system.load.1{*}
+            style:
+              line_type: solid
+              line_width: normal
+              palette: dog_classic
+          show_legend: true
+          type: timeseries
+          yaxis:
+            scale: linear
+        graph_size: m
+        split_by:
+          keys: []
+          tags: []
+        time: null
+      oneOf:
+      - $ref: '#/components/schemas/NotebookMarkdownCellAttributes'
+      - $ref: '#/components/schemas/NotebookTimeseriesCellAttributes'
+      - $ref: '#/components/schemas/NotebookToplistCellAttributes'
+      - $ref: '#/components/schemas/NotebookHeatMapCellAttributes'
+      - $ref: '#/components/schemas/NotebookDistributionCellAttributes'
+      - $ref: '#/components/schemas/NotebookLogStreamCellAttributes'
+      type: object
+    NotebookCreateData:
+      description: The data for a notebook create request.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/NotebookCreateDataAttributes'
+        type:
+          $ref: '#/components/schemas/NotebookResourceType'
+      required:
+      - type
+      - attributes
+      type: object
+    NotebookCreateDataAttributes:
+      description: The data attributes of a notebook.
+      properties:
+        cells:
+          description: List of cells to display in the notebook.
+          example:
+          - attributes:
+              definition:
+                text: '## Some test markdown
+
+
+                  ```js
+
+                  var x, y;
+
+                  x = 5;
+
+                  y = 6;
+
+                  ```'
+                type: markdown
+            type: notebook_cells
+          - attributes:
+              definition:
+                requests:
+                - display_type: line
+                  q: avg:system.load.1{*}
+                  style:
+                    line_type: solid
+                    line_width: normal
+                    palette: dog_classic
+                show_legend: true
+                type: timeseries
+                yaxis:
+                  scale: linear
+              graph_size: m
+              split_by:
+                keys: []
+                tags: []
+              time: null
+            type: notebook_cells
+          items:
+            $ref: '#/components/schemas/NotebookCellCreateRequest'
+          type: array
+        name:
+          description: Notebook name.
+          example: Example Notebook
+          maxLength: 80
+          minLength: 0
+          type: string
+        status:
+          $ref: '#/components/schemas/NotebookStatus'
+        time:
+          $ref: '#/components/schemas/NotebookGlobalTime'
+      required:
+      - name
+      - cells
+      - time
+      type: object
+    NotebookCreateRequest:
+      description: The description of a notebook create request.
+      properties:
+        data:
+          $ref: '#/components/schemas/NotebookCreateData'
+      required:
+      - data
+      type: object
+    NotebookDistributionCellAttributes:
+      description: The attributes of a notebook distribution cell.
+      properties:
+        definition:
+          $ref: '#/components/schemas/DistributionWidgetDefinition'
+        graph_size:
+          $ref: '#/components/schemas/NotebookGraphSize'
+        split_by:
+          $ref: '#/components/schemas/NotebookSplitBy'
+        time:
+          $ref: '#/components/schemas/NotebookCellTime'
+      required:
+      - definition
+      type: object
+    NotebookGlobalTime:
+      description: Notebook global timeframe.
+      oneOf:
+      - $ref: '#/components/schemas/NotebookRelativeTime'
+      - $ref: '#/components/schemas/NotebookAbsoluteTime'
+      type: object
+    NotebookGraphSize:
+      description: The size of the graph.
+      enum:
+      - xs
+      - s
+      - m
+      - l
+      - xl
+      type: string
+      x-enum-varnames:
+      - EXTRA_SMALL
+      - SMALL
+      - MEDIUM
+      - LARGE
+      - EXTRA_LARGE
+    NotebookHeatMapCellAttributes:
+      description: The attributes of a notebook heat map cell.
+      properties:
+        definition:
+          $ref: '#/components/schemas/HeatMapWidgetDefinition'
+        graph_size:
+          $ref: '#/components/schemas/NotebookGraphSize'
+        split_by:
+          $ref: '#/components/schemas/NotebookSplitBy'
+        time:
+          $ref: '#/components/schemas/NotebookCellTime'
+      required:
+      - definition
+      type: object
+    NotebookLogStreamCellAttributes:
+      description: The attributes of a notebook log stream cell.
+      properties:
+        definition:
+          $ref: '#/components/schemas/LogStreamWidgetDefinition'
+        graph_size:
+          $ref: '#/components/schemas/NotebookGraphSize'
+        time:
+          $ref: '#/components/schemas/NotebookCellTime'
+      required:
+      - definition
+      type: object
+    NotebookMarkdownCellAttributes:
+      description: The attributes of a notebooks markdown cell.
+      properties:
+        definition:
+          $ref: '#/components/schemas/NotebookMarkdownCellDefinition'
+      required:
+      - definition
+      type: object
+    NotebookMarkdownCellDefinition:
+      description: Text in a notebook is formatted with [Markdown](https://daringfireball.net/projects/markdown/),
+        which enables the use of headings, subheadings, links, images, lists, and
+        code blocks.
+      properties:
+        text:
+          description: The markdown content.
+          example: "# Example Header \nexample content"
+          type: string
+        type:
+          $ref: '#/components/schemas/NotebookMarkdownCellDefinitionType'
+      required:
+      - type
+      - text
+      type: object
+    NotebookMarkdownCellDefinitionType:
+      default: markdown
+      description: Type of the markdown cell.
+      enum:
+      - markdown
+      example: markdown
+      type: string
+      x-enum-varnames:
+      - MARKDOWN
+    NotebookRelativeTime:
+      description: Relative timeframe.
+      example:
+        live_span: 1h
+      properties:
+        live_span:
+          $ref: '#/components/schemas/WidgetLiveSpan'
+      required:
+      - live_span
+      type: object
+    NotebookResourceType:
+      default: notebooks
+      description: Type of the Notebook resource.
+      enum:
+      - notebooks
+      example: notebooks
+      type: string
+      x-enum-varnames:
+      - NOTEBOOKS
+    NotebookResponse:
+      description: The description of a notebook response.
+      properties:
+        data:
+          $ref: '#/components/schemas/NotebookResponseData'
+      type: object
+    NotebookResponseData:
+      description: The data for a notebook.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/NotebookResponseDataAttributes'
+        id:
+          description: Unique notebook ID, assigned when you create the notebook.
+          example: 123456
+          format: int64
+          readOnly: true
+          type: integer
+        type:
+          $ref: '#/components/schemas/NotebookResourceType'
+      required:
+      - id
+      - type
+      - attributes
+      type: object
+    NotebookResponseDataAttributes:
+      description: The attributes of a notebook.
+      properties:
+        author:
+          $ref: '#/components/schemas/NotebookAuthor'
+        cells:
+          description: List of cells to display in the notebook.
+          example:
+          - attributes:
+              definition:
+                text: '## Some test markdown
+
+
+                  ```js
+
+                  var x, y;
+
+                  x = 5;
+
+                  y = 6;
+
+                  ```'
+                type: markdown
+            id: bzbycoya
+            type: notebook_cells
+          - attributes:
+              definition:
+                requests:
+                - display_type: line
+                  q: avg:system.load.1{*}
+                  style:
+                    line_type: solid
+                    line_width: normal
+                    palette: dog_classic
+                show_legend: true
+                type: timeseries
+                yaxis:
+                  scale: linear
+              graph_size: m
+              split_by:
+                keys: []
+                tags: []
+              time: null
+            id: 9k6bc6xc
+            type: notebook_cells
+          items:
+            $ref: '#/components/schemas/NotebookCellResponse'
+          type: array
+        created:
+          description: UTC time stamp.
+          example: '2021-02-24T23:14:15.173964+00:00'
+          format: date-time
+          readOnly: true
+          type: string
+        modified:
+          description: UTC time stamp.
+          example: '2021-02-24T23:15:23.274966+00:00'
+          format: date-time
+          readOnly: true
+          type: string
+        name:
+          description: Notebook name.
+          example: Example Notebook
+          maxLength: 80
+          minLength: 0
+          type: string
+        status:
+          $ref: '#/components/schemas/NotebookStatus'
+        time:
+          $ref: '#/components/schemas/NotebookGlobalTime'
+      required:
+      - cells
+      - time
+      - name
+      type: object
+    NotebookSplitBy:
+      description: Object describing how to split the graph to display multiple visualizations
+        per request.
+      properties:
+        keys:
+          description: Keys to split on.
+          items:
+            description: A key to split on.
+            example: environment
+            type: string
+          type: array
+        tags:
+          description: Tags to split on.
+          items:
+            description: A tag to split on.
+            example: environment:staging
+            type: string
+          type: array
+      required:
+      - keys
+      - tags
+      type: object
+    NotebookStatus:
+      default: published
+      description: Publication status of the notebook. For now, always "published".
+      enum:
+      - published
+      example: published
+      type: string
+      x-enum-varnames:
+      - PUBLISHED
+    NotebookTimeseriesCellAttributes:
+      description: The attributes of a notebook timeseries cell.
+      properties:
+        definition:
+          $ref: '#/components/schemas/TimeseriesWidgetDefinition'
+        graph_size:
+          $ref: '#/components/schemas/NotebookGraphSize'
+        split_by:
+          $ref: '#/components/schemas/NotebookSplitBy'
+        time:
+          $ref: '#/components/schemas/NotebookCellTime'
+      required:
+      - definition
+      type: object
+    NotebookToplistCellAttributes:
+      description: The attributes of a notebook toplist cell.
+      properties:
+        definition:
+          $ref: '#/components/schemas/ToplistWidgetDefinition'
+        graph_size:
+          $ref: '#/components/schemas/NotebookGraphSize'
+        split_by:
+          $ref: '#/components/schemas/NotebookSplitBy'
+        time:
+          $ref: '#/components/schemas/NotebookCellTime'
+      required:
+      - definition
+      type: object
+    NotebookUpdateCell:
+      description: 'Updating a notebook can either insert new cell(s) or update existing
+        cell(s) by including the cell `id`.
+
+        To delete existing cell(s), simply omit it from the list of cells.'
+      oneOf:
+      - $ref: '#/components/schemas/NotebookCellCreateRequest'
+      - $ref: '#/components/schemas/NotebookCellUpdateRequest'
+      type: object
+    NotebookUpdateData:
+      description: The data for a notebook update request.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/NotebookUpdateDataAttributes'
+        type:
+          $ref: '#/components/schemas/NotebookResourceType'
+      required:
+      - type
+      - attributes
+      type: object
+    NotebookUpdateDataAttributes:
+      description: The data attributes of a notebook.
+      properties:
+        cells:
+          description: List of cells to display in the notebook.
+          example:
+          - attributes:
+              definition:
+                text: '## Some test markdown
+
+
+                  ```js
+
+                  var x, y;
+
+                  x = 5;
+
+                  y = 6;
+
+                  ```'
+                type: markdown
+            id: bzbycoya
+            type: notebook_cells
+          - attributes:
+              definition:
+                requests:
+                - display_type: line
+                  q: avg:system.load.1{*}
+                  style:
+                    line_type: solid
+                    line_width: normal
+                    palette: dog_classic
+                show_legend: true
+                type: timeseries
+                yaxis:
+                  scale: linear
+              graph_size: m
+              split_by:
+                keys: []
+                tags: []
+              time: null
+            id: 9k6bc6xc
+            type: notebook_cells
+          items:
+            $ref: '#/components/schemas/NotebookUpdateCell'
+          type: array
+        name:
+          description: Notebook name.
+          example: Example Notebook
+          maxLength: 80
+          minLength: 0
+          type: string
+        status:
+          $ref: '#/components/schemas/NotebookStatus'
+        time:
+          $ref: '#/components/schemas/NotebookGlobalTime'
+      required:
+      - name
+      - cells
+      - time
+      type: object
+    NotebookUpdateRequest:
+      description: The description of a notebook update request.
+      properties:
+        data:
+          $ref: '#/components/schemas/NotebookUpdateData'
+      required:
+      - data
+      type: object
+    NotebooksResponse:
+      description: Notebooks get all response.
+      properties:
+        data:
+          description: List of notebook definitions.
+          items:
+            $ref: '#/components/schemas/NotebookResponseData'
           type: array
-        type:
-          $ref: '#/components/schemas/MonitorType'
+        meta:
+          description: Metadata returned by the API.
+          properties:
+            page:
+              $ref: '#/components/schemas/NotebooksResponsePage'
+          type: object
       type: object
-    NoteWidgetDefinition:
-      description: The notes and links widget is similar to free text widget, but
-        allows for more formatting options.
+    NotebooksResponsePage:
+      description: Pagination metadata returned by the API.
       properties:
-        background_color:
-          description: Background color of the note.
-          type: string
-        content:
-          description: Content of the note.
-          example: ''
-          type: string
-        font_size:
-          description: Size of the text.
-          type: string
-        show_tick:
-          description: Whether to show a tick or not.
-          type: boolean
-        text_align:
-          $ref: '#/components/schemas/WidgetTextAlign'
-        tick_edge:
-          $ref: '#/components/schemas/WidgetTickEdge'
-        tick_pos:
-          description: Where to position the tick on an edge.
-          type: string
-        type:
-          $ref: '#/components/schemas/NoteWidgetDefinitionType'
-      required:
-      - type
-      - content
+        total_count:
+          description: The total number of notebooks that would be returned if the
+            request was not filtered by `start` and `count` parameters.
+          format: int64
+          type: integer
+        total_filtered_count:
+          description: The total number of notebooks returned.
+          format: int64
+          type: integer
       type: object
-    NoteWidgetDefinitionType:
-      default: note
-      description: Type of the note widget.
-      enum:
-      - note
-      example: note
-      type: string
-      x-enum-varnames:
-      - NOTE
     Organization:
       description: Create, edit, and manage organizations.
       properties:
@@ -6033,13 +6870,171 @@ components:
             description: The error message.
             type: string
           type: array
+        metadata:
+          description: The metadata object containing additional information about
+            the list of SLOs.
+          properties:
+            page:
+              description: The object containing information about the pages of the
+                list of SLOs.
+              properties:
+                total_count:
+                  description: The total number of resources that could be retrieved
+                    ignoring the parameters and filters in the request.
+                  format: int64
+                  type: integer
+                total_filtered_count:
+                  description: The total number of resources that match the parameters
+                    and filters in the request. This attribute can be used by a client
+                    to determine the total number of pages.
+                  format: int64
+                  type: integer
+              type: object
+          type: object
       type: object
     SLOResponse:
       description: A service level objective response containing a single service
         level objective.
       properties:
         data:
-          $ref: '#/components/schemas/ServiceLevelObjective'
+          description: 'A service level objective object includes a service level
+            indicator, thresholds
+
+            for one or more timeframes, and metadata (`name`, `description`, `tags`,
+            etc.).'
+          properties:
+            configured_alert_ids:
+              description: A list of SLO monitors IDs that reference this SLO. This
+                field is returned only when `with_configured_alert_ids` parameter
+                is true in query.
+              example:
+              - 123
+              - 456
+              - 789
+              items:
+                description: A monitor ID.
+                format: int64
+                type: integer
+              type: array
+            created_at:
+              description: 'Creation timestamp (UNIX time in seconds)
+
+
+                Always included in service level objective responses.'
+              format: int64
+              readOnly: true
+              type: integer
+            creator:
+              $ref: '#/components/schemas/Creator'
+            description:
+              description: 'A user-defined description of the service level objective.
+
+
+                Always included in service level objective responses (but may be `null`).
+
+                Optional in create/update requests.'
+              nullable: true
+              type: string
+            groups:
+              description: 'A list of (up to 20) monitor groups that narrow the scope
+                of a monitor service level objective.
+
+
+                Included in service level objective responses if it is not empty.
+                Optional in
+
+                create/update requests for monitor service level objectives, but may
+                only be
+
+                used when then length of the `monitor_ids` field is one.'
+              example:
+              - env:prod
+              - role:mysql
+              items:
+                description: A group name, for instance `env:prod`.
+                type: string
+              type: array
+            id:
+              description: 'A unique identifier for the service level objective object.
+
+
+                Always included in service level objective responses.'
+              readOnly: true
+              type: string
+            modified_at:
+              description: 'Modification timestamp (UNIX time in seconds)
+
+
+                Always included in service level objective responses.'
+              format: int64
+              readOnly: true
+              type: integer
+            monitor_ids:
+              description: 'A list of monitor ids that defines the scope of a monitor
+                service level
+
+                objective. **Required if type is `monitor`**.'
+              items:
+                description: A monitor ID.
+                format: int64
+                type: integer
+              type: array
+            monitor_tags:
+              description: 'The union of monitor tags for all monitors referenced
+                by the `monitor_ids`
+
+                field.
+
+                Always included in service level objective responses for monitor service
+                level
+
+                objectives (but may be empty). Ignored in create/update requests.
+                Does not
+
+                affect which monitors are included in the service level objective
+                (that is
+
+                determined entirely by the `monitor_ids` field).'
+              items:
+                description: A monitor tag.
+                type: string
+              type: array
+            name:
+              description: The name of the service level objective object.
+              example: Custom Metric SLO
+              type: string
+            query:
+              $ref: '#/components/schemas/ServiceLevelObjectiveQuery'
+            tags:
+              description: 'A list of tags associated with this service level objective.
+
+                Always included in service level objective responses (but may be empty).
+
+                Optional in create/update requests.'
+              example:
+              - env:prod
+              - app:core
+              items:
+                description: A tag to apply to your SLO.
+                type: string
+              type: array
+            thresholds:
+              description: 'The thresholds (timeframes and associated targets) for
+                this service level
+
+                objective object.'
+              example:
+              - target: 95
+                timeframe: 7d
+              - target: 95
+                timeframe: 30d
+                warning: 97
+              items:
+                $ref: '#/components/schemas/SLOThreshold'
+              type: array
+            type:
+              $ref: '#/components/schemas/SLOType'
+          type: object
         errors:
           description: 'An array of error messages. Each endpoint documents how/whether
             this field is
@@ -6763,6 +7758,10 @@ components:
     SyntheticsAPIStep:
       description: The steps used in a Synthetics multistep API test.
       properties:
+        allowFailure:
+          description: Determines whether or not to continue with test if this step
+            fails.
+          type: boolean
         assertions:
           default: []
           description: Array of assertions used for the test.
@@ -6775,6 +7774,12 @@ components:
           items:
             $ref: '#/components/schemas/SyntheticsParsingOptions'
           type: array
+        isCritical:
+          description: 'Determines whether or not to consider the entire test as failed
+            if this step fails.
+
+            Can be used only if `allowFailure` is `true`.'
+          type: boolean
         name:
           description: The name of the step.
           type: string
@@ -7061,6 +8066,10 @@ components:
       - recordSome
       - tlsVersion
       - minTlsVersion
+      - latency
+      - packetLossPercentage
+      - packetsReceived
+      - networkHop
       type: string
       x-enum-varnames:
       - BODY
@@ -7073,6 +8082,10 @@ components:
       - RECORD_SOME
       - TLS_VERSION
       - MIN_TLS_VERSION
+      - LATENCY
+      - PACKET_LOSS_PERCENTAGE
+      - PACKETS_RECEIVED
+      - NETWORK_HOP
     SyntheticsBasicAuth:
       description: Object to handle basic authentication when performing the test.
       properties:
@@ -7177,6 +8190,10 @@ components:
           type: array
         request:
           $ref: '#/components/schemas/SyntheticsTestRequest'
+        setCookie:
+          description: Cookies to be used for the request, using the [Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie)
+            syntax.
+          type: string
         variables:
           description: Array of variables used for the test steps.
           items:
@@ -7423,6 +8440,7 @@ components:
           type: object
       required:
       - public_id
+      type: object
     SyntheticsCITestBody:
       description: Object describing the synthetics tests to trigger.
       properties:
@@ -7734,6 +8752,7 @@ components:
           type: string
       required:
       - value
+      type: object
     SyntheticsListTestsResponse:
       description: Object containing an array of Synthetic tests configuration.
       properties:
@@ -8134,7 +9153,6 @@ components:
             $ref: '#/components/schemas/SyntheticsBrowserVariable'
           type: array
       required:
-      - request
       - assertions
       type: object
     SyntheticsTestDetails:
@@ -8184,13 +9202,14 @@ components:
     SyntheticsTestDetailsSubType:
       description: 'The subtype of the Synthetic API test, `http`, `ssl`, `tcp`,
 
-        `dns` or `multi`.'
+        `dns`, `icmp` or `multi`.'
       enum:
       - http
       - ssl
       - tcp
       - dns
       - multi
+      - icmp
       type: string
       x-enum-varnames:
       - HTTP
@@ -8198,6 +9217,7 @@ components:
       - TCP
       - DNS
       - MULTI
+      - ICMP
     SyntheticsTestDetailsType:
       description: Type of the Synthetic test, either `api` or `browser`.
       enum:
@@ -8249,8 +9269,7 @@ components:
             $ref: '#/components/schemas/SyntheticsDeviceID'
           type: array
         disableCors:
-          description: Whether or not to disable CORS mechanism. Currently only available
-            for Chrome.
+          description: Whether or not to disable CORS mechanism.
           type: boolean
         follow_redirects:
           description: For API HTTP test, whether or not the test should follow redirects.
@@ -8346,6 +9365,12 @@ components:
         dnsServer:
           description: DNS server to use for DNS tests.
           type: string
+        dnsServerPort:
+          description: DNS server port to use for DNS tests.
+          format: int32
+          maximum: 65535
+          minimum: 1
+          type: integer
         headers:
           $ref: '#/components/schemas/SyntheticsTestHeaders'
         host:
@@ -8356,6 +9381,12 @@ components:
         noSavingResponseBody:
           description: Determines whether or not to save the response body.
           type: boolean
+        numberOfPackets:
+          description: Number of pings to use per test.
+          format: int32
+          maximum: 10
+          minimum: 0
+          type: integer
         port:
           description: Port to use when performing the test.
           format: int64
@@ -8363,6 +9394,10 @@ components:
         query:
           description: Query to use for the test.
           type: object
+        shouldTrackHops:
+          description: Turns on a traceroute probe to discover all gateways along
+            the path to the host destination.
+          type: boolean
         timeout:
           description: Timeout in seconds for the test.
           format: double
@@ -8395,6 +9430,7 @@ components:
     SyntheticsTickInterval:
       description: The frequency at which to run the Synthetic test (in seconds).
       enum:
+      - 30
       - 60
       - 300
       - 900
@@ -8407,6 +9443,7 @@ components:
       format: int64
       type: integer
       x-enum-varnames:
+      - THIRTY_SECONDS
       - MINUTE
       - FIVE_MINUTES
       - FIFTEEN_MINUTES
@@ -9083,6 +10120,70 @@ components:
       - LAMBDA_INVOCATIONS_PERCENTAGE
       - LAMBDA_USAGE
       - LAMBDA_PERCENTAGE
+    UsageAttributionSupportedMetrics:
+      description: Supported fields for usage attribution requests (valid requests
+        contain one or more metrics, or `*` for all).
+      enum:
+      - custom_timeseries_usage
+      - container_usage
+      - snmp_percentage
+      - apm_host_usage
+      - browser_usage
+      - npm_host_percentage
+      - infra_host_usage
+      - custom_timeseries_percentage
+      - container_percentage
+      - lambda_usage
+      - api_usage
+      - apm_host_percentage
+      - infra_host_percentage
+      - snmp_usage
+      - browser_percentage
+      - api_percentage
+      - lambda_percentage
+      - npm_host_usage
+      - lambda_functions_usage
+      - lambda_functions_percentage
+      - lambda_invocations_usage
+      - lambda_invocations_percentage
+      - fargate_usage
+      - fargate_percentage
+      - profiled_host_usage
+      - profiled_host_percentage
+      - profiled_container_usage
+      - profiled_container_percentage
+      - '*'
+      type: string
+      x-enum-varnames:
+      - CUSTOM_TIMESERIES_USAGE
+      - CONTAINER_USAGE
+      - SNMP_PERCENTAGE
+      - APM_HOST_USAGE
+      - BROWSER_USAGE
+      - NPM_HOST_PERCENTAGE
+      - INFRA_HOST_USAGE
+      - CUSTOM_TIMESERIES_PERCENTAGE
+      - CONTAINER_PERCENTAGE
+      - LAMBDA_USAGE
+      - API_USAGE
+      - APM_HOST_PERCENTAGE
+      - INFRA_HOST_PERCENTAGE
+      - SNMP_USAGE
+      - BROWSER_PERCENTAGE
+      - API_PERCENTAGE
+      - LAMBDA_PERCENTAGE
+      - NPM_HOST_USAGE
+      - LAMBDA_FUNCTIONS_USAGE
+      - LAMBDA_FUNCTIONS_PERCENTAGE
+      - LAMBDA_INVOCATIONS_USAGE
+      - LAMBDA_INVOCATIONS_PERCENTAGE
+      - FARGATE_USAGE
+      - FARGATE_PERCENTAGE
+      - PROFILED_HOST_USAGE
+      - PROFILED_HOST_PERCENTAGE
+      - PROFILED_CONTAINER_USAGE
+      - PROFILED_CONTAINER_PERCENTAGE
+      - ALL
     UsageAttributionTagNames:
       additionalProperties:
         description: A list of tag values.
@@ -9182,6 +10283,22 @@ components:
           description: The network host usage by tag(s).
           format: double
           type: number
+        profiled_containers_percentage:
+          description: The percentage of profiled containers usage by tag(s).
+          format: double
+          type: number
+        profiled_containers_usage:
+          description: The profiled container usage by tag(s).
+          format: double
+          type: number
+        profiled_hosts_percentage:
+          description: The percentage of profiled hosts usage by tag(s).
+          format: double
+          type: number
+        profiled_hosts_usage:
+          description: The profiled host usage by tag(s).
+          format: double
+          type: number
         snmp_percentage:
           description: The percentage of network device usage by tag(s).
           format: double
@@ -9497,6 +10614,13 @@ components:
             for the OpenTelemetry Collector.
           format: int64
           type: integer
+        vsphere_host_count:
+          description: 'Contains the total number of hosts that reported via vSphere
+            integration
+
+            (and were NOT running the Datadog Agent).'
+          format: int64
+          type: integer
       type: object
     UsageHostsResponse:
       description: Host usage response.
@@ -9584,8 +10708,7 @@ components:
           format: date-time
           type: string
         iot_device_count:
-          description: The total number of IoT device hours from the start of the
-            given hour's month until the given hour.
+          description: The total number of IoT devices during a given hour.
           format: int64
           type: integer
       type: object
@@ -9663,6 +10786,40 @@ components:
             $ref: '#/components/schemas/UsageLogsByIndexHour'
           type: array
       type: object
+    UsageLogsByRetentionHour:
+      description: The number of indexed logs for each hour for a given organization
+        broken down by retention period.
+      properties:
+        indexed_events_count:
+          description: Total logs indexed with this retention period during a given
+            hour.
+          format: int64
+          type: integer
+        live_indexed_events_count:
+          description: Live logs indexed with this retention period during a given
+            hour.
+          format: int64
+          type: integer
+        rehydrated_indexed_events_count:
+          description: Rehydrated logs indexed with this retention period during a
+            given hour.
+          format: int64
+          type: integer
+        retention:
+          description: The retention period in days or "custom" for all custom retention
+            usage.
+          type: string
+      type: object
+    UsageLogsByRetentionResponse:
+      description: Response containing the indexed logs usage broken down by retention
+        period for an organization during a given hour.
+      properties:
+        usage:
+          description: Get hourly usage for indexed logs by retention period.
+          items:
+            $ref: '#/components/schemas/UsageLogsByRetentionHour'
+          type: array
+      type: object
     UsageLogsHour:
       description: Hour usage for logs.
       properties:
@@ -10025,7 +11182,7 @@ components:
             the current date for all organizations.
           format: int64
           type: integer
-        heroku_host_top99p_sum:
+        heroku_host_top99p:
           description: Shows the 99th percentile of all Heroku dynos over all hours
             in the current date for all organizations.
           format: int64
@@ -10050,12 +11207,12 @@ components:
             current date for all organizations.
           format: int64
           type: integer
-        iot_device_agg_sum:
+        iot_device_sum:
           description: Shows the sum of all IoT devices over all hours in the current
             date for all organizations.
           format: int64
           type: integer
-        iot_device_top99p_sum:
+        iot_device_top99p:
           description: Shows the 99th percentile of all IoT devices over all hours
             in the current date all organizations.
           format: int64
@@ -10085,7 +11242,7 @@ components:
             all hours in the current date for all organizations.
           format: int64
           type: integer
-        opentelemetry_host_top99p_sum:
+        opentelemetry_host_top99p:
           description: Shows the 99th percentile of all hosts reported by the Datadog
             exporter for the OpenTelemetry Collector over all hours in the current
             date for all organizations.
@@ -10131,6 +11288,11 @@ components:
             over all hours in the current date for all organizations.
           format: int64
           type: integer
+        vsphere_host_top99p:
+          description: Shows the 99th percentile of all vSphere hosts over all hours
+            in the current date for all organizations.
+          format: int64
+          type: integer
       type: object
     UsageSummaryDateOrg:
       description: Global hourly report of all data billed by Datadog for a given
@@ -10323,6 +11485,11 @@ components:
             over all hours in the current date for the given org.
           format: int64
           type: integer
+        vsphere_host_top99p:
+          description: Shows the 99th percentile of all vSphere hosts over all hours
+            in the current date for the given org.
+          format: int64
+          type: integer
       type: object
     UsageSummaryResponse:
       description: Response with hourly report of all data billed by Datadog all organizations.
@@ -10467,6 +11634,8 @@ components:
             1, 2020).
           format: int64
           type: integer
+        logs_by_retention:
+          $ref: '#/components/schemas/LogsByRetention'
         mobile_rum_session_count_agg_sum:
           description: Shows the sum of all mobile RUM Sessions over all hours in
             the current months for all organizations.
@@ -10560,6 +11729,11 @@ components:
           items:
             $ref: '#/components/schemas/UsageSummaryDate'
           type: array
+        vsphere_host_top99p_sum:
+          description: Shows the 99th percentile of all vSphere hosts over all hours
+            in the current months for all organizations.
+          format: int64
+          type: integer
       type: object
     UsageSyntheticsAPIHour:
       description: Number of Synthetics API tests run for each hour for a given organization.
@@ -10804,11 +11978,11 @@ components:
           $ref: '#/components/schemas/User'
       type: object
     Widget:
-      description: 'Information about widget.
-
-
-        Note: The `layout` property is required for widgets in dashboards with `free`
-        `layout_type` only.'
+      description: "Information about widget.\n\n**Note**: The `layout` property is\
+        \ required for widgets in dashboards with `free` `layout_type`.\n      For\
+        \ the **new dashboard layout**, the `layout` property depends on the `reflow_type`\
+        \ of the dashboard.\n      - If `reflow_type` is `fixed`, `layout` is required.\n\
+        \      - If `reflow_type` is `auto`, `layout` should not be set."
       properties:
         definition:
           $ref: '#/components/schemas/WidgetDefinition'
@@ -11073,19 +12247,44 @@ components:
       x-enum-varnames:
       - CHECK
       - CLUSTER
+    WidgetHorizontalAlign:
+      description: Horizontal alignment.
+      enum:
+      - center
+      - left
+      - right
+      type: string
+      x-enum-varnames:
+      - CENTER
+      - LEFT
+      - RIGHT
     WidgetImageSizing:
-      description: How to size the image on the widget.
+      description: 'How to size the image on the widget. The values are based on the
+        image `object-fit` CSS properties.
+
+        **Note**: `zoom`, `fit` and `center` values are deprecated.'
       enum:
+      - fill
+      - contain
+      - cover
+      - none
+      - scale-down
       - zoom
       - fit
       - center
       type: string
       x-enum-varnames:
+      - FILL
+      - CONTAIN
+      - COVER
+      - NONE
+      - SCALEDOWN
       - ZOOM
       - FIT
       - CENTER
     WidgetLayout:
-      description: The layout for a widget on a free dashboard.
+      description: The layout for a widget on a `free` or **new dashboard layout**
+        dashboard.
       properties:
         height:
           description: The height of the widget. Should be a non-negative integer.
@@ -11093,6 +12292,13 @@ components:
           format: int64
           minimum: 0
           type: integer
+        is_column_break:
+          description: 'Whether the widget should be the first one on the second column
+            in high density or not.
+
+            **Note**: Only for the **new dashboard layout** and only one widget in
+            the dashboard should have this property set to `true`.'
+          type: boolean
         width:
           description: The width of the widget. Should be a non-negative integer.
           example: 0
@@ -11188,12 +12394,20 @@ components:
       - PAST_ONE_YEAR
       - ALERT
     WidgetMargin:
-      description: Size of the margins around the image.
+      description: 'Size of the margins around the image.
+
+        **Note**: `small` and `large` values are deprecated.'
       enum:
+      - sm
+      - md
+      - lg
       - small
       - large
       type: string
       x-enum-varnames:
+      - SM
+      - MD
+      - LG
       - SMALL
       - LARGE
     WidgetMarker:
@@ -11202,7 +12416,8 @@ components:
       properties:
         display_type:
           description: "Combination of:\n  - A severity error, warning, ok, or info\n\
-            \  - A line type: dashed, solid, or bold\n"
+            \  - A line type: dashed, solid, or bold\nIn this case of a Distribution\
+            \ widget, this can be set to be `x_axis_percentile`.\n"
           example: error dashed
           type: string
         label:
@@ -11452,6 +12667,17 @@ components:
       - MONTH_TO_DATE
       - PREVIOUS_MONTH
       - GLOBAL_TIME
+    WidgetVerticalAlign:
+      description: Vertical alignment.
+      enum:
+      - center
+      - top
+      - bottom
+      type: string
+      x-enum-varnames:
+      - CENTER
+      - TOP
+      - BOTTOM
     WidgetViewMode:
       description: Define how you want the SLO to be displayed.
       enum:
@@ -11551,6 +12777,7 @@ paths:
       summary: List IP Ranges
       tags:
       - IP Ranges
+      x-menu-order: 1
       x-undo:
         type: safe
   /api/v1/api_key:
@@ -11573,6 +12800,7 @@ paths:
       summary: Get all API keys
       tags:
       - Key Management
+      x-menu-order: 1
       x-undo:
         type: safe
     post:
@@ -11607,6 +12835,7 @@ paths:
       tags:
       - Key Management
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         operationId: DeleteAPIKey
         parameters:
@@ -11652,6 +12881,7 @@ paths:
       summary: Delete an API key
       tags:
       - Key Management
+      x-menu-order: 5
       x-undo:
         type: idempotent
     get:
@@ -11686,6 +12916,7 @@ paths:
       summary: Get API key
       tags:
       - Key Management
+      x-menu-order: 3
       x-undo:
         type: safe
     put:
@@ -11733,6 +12964,7 @@ paths:
       tags:
       - Key Management
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/application_key:
@@ -11755,6 +12987,7 @@ paths:
       summary: Get all application keys
       tags:
       - Key Management
+      x-menu-order: 6
       x-undo:
         type: safe
     post:
@@ -11795,6 +13028,7 @@ paths:
       tags:
       - Key Management
       x-codegen-request-body-name: body
+      x-menu-order: 7
       x-undo:
         operationId: DeleteApplicationKey
         parameters:
@@ -11834,6 +13068,7 @@ paths:
       summary: Delete an application key
       tags:
       - Key Management
+      x-menu-order: 10
       x-undo:
         type: idempotent
     get:
@@ -11868,6 +13103,7 @@ paths:
       summary: Get an application key
       tags:
       - Key Management
+      x-menu-order: 8
       x-undo:
         type: safe
     put:
@@ -11921,6 +13157,7 @@ paths:
       tags:
       - Key Management
       x-codegen-request-body-name: body
+      x-menu-order: 9
       x-undo:
         type: idempotent
   /api/v1/check_run:
@@ -11974,6 +13211,7 @@ paths:
       tags:
       - Service Checks
       x-codegen-request-body-name: body
+      x-menu-order: 1
       x-undo:
         type: safe
   /api/v1/daily_custom_reports:
@@ -12024,6 +13262,7 @@ paths:
       summary: Get the list of available daily custom reports
       tags:
       - Usage Metering
+      x-menu-order: 20
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -12062,6 +13301,7 @@ paths:
       summary: Get specified daily custom reports
       tags:
       - Usage Metering
+      x-menu-order: 21
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -12076,6 +13316,15 @@ paths:
 
         This query will not return preset dashboards.'
       operationId: ListDashboards
+      parameters:
+      - description: 'When `true`, this query only returns shared custom created
+
+          or cloned dashboards.'
+        in: query
+        name: filter[shared]
+        required: false
+        schema:
+          type: boolean
       responses:
         '200':
           content:
@@ -12092,6 +13341,7 @@ paths:
       summary: Get all dashboards
       tags:
       - Dashboards
+      x-menu-order: 2
       x-undo:
         type: safe
     post:
@@ -12132,6 +13382,13 @@ paths:
       tags:
       - Dashboards
       x-codegen-request-body-name: body
+      x-given:
+        dashboard:
+          parameters:
+          - file: dashboard_payload.json
+            name: body
+          step: there is a valid "dashboard" in the system
+      x-menu-order: 1
       x-undo:
         operationId: DeleteDashboard
         parameters:
@@ -12158,6 +13415,7 @@ paths:
       summary: Get all dashboard lists
       tags:
       - Dashboard Lists
+      x-menu-order: 1
       x-undo:
         type: safe
     post:
@@ -12193,6 +13451,7 @@ paths:
       tags:
       - Dashboard Lists
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         operationId: DeleteDashboardList
         parameters:
@@ -12233,6 +13492,7 @@ paths:
       summary: Delete a dashboard list
       tags:
       - Dashboard Lists
+      x-menu-order: 5
       x-undo:
         type: idempotent
     get:
@@ -12268,6 +13528,7 @@ paths:
       summary: Get a dashboard list
       tags:
       - Dashboard Lists
+      x-menu-order: 3
       x-undo:
         type: safe
     put:
@@ -12317,6 +13578,7 @@ paths:
       tags:
       - Dashboard Lists
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/dashboard/{dashboard_id}:
@@ -12352,6 +13614,7 @@ paths:
       summary: Delete a dashboard
       tags:
       - Dashboards
+      x-menu-order: 3
       x-undo:
         type: idempotent
     get:
@@ -12386,6 +13649,7 @@ paths:
       summary: Get a dashboard
       tags:
       - Dashboards
+      x-menu-order: 5
       x-undo:
         type: safe
     put:
@@ -12434,6 +13698,7 @@ paths:
       tags:
       - Dashboards
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/downtime:
@@ -12465,6 +13730,7 @@ paths:
       summary: Get all downtimes
       tags:
       - Downtimes
+      x-menu-order: 1
       x-undo:
         type: safe
     post:
@@ -12500,6 +13766,7 @@ paths:
       tags:
       - Downtimes
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         operationId: TODO
         parameters: []
@@ -12544,6 +13811,7 @@ paths:
       tags:
       - Downtimes
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: idempotent
   /api/v1/downtime/{downtime_id}:
@@ -12577,6 +13845,7 @@ paths:
       summary: Cancel a downtime
       tags:
       - Downtimes
+      x-menu-order: 4
       x-undo:
         type: idempotent
     get:
@@ -12613,6 +13882,7 @@ paths:
       summary: Get a downtime
       tags:
       - Downtimes
+      x-menu-order: 5
       x-undo:
         type: safe
     put:
@@ -12664,6 +13934,7 @@ paths:
       tags:
       - Downtimes
       x-codegen-request-body-name: body
+      x-menu-order: 6
       x-undo:
         type: idempotent
   /api/v1/events:
@@ -12674,7 +13945,8 @@ paths:
         `,`n` in your output.\n\n- This endpoint returns a maximum of `1000` most\
         \ recent results. To return additional results,\nidentify the last timestamp\
         \ of the last result and set that as the `end` query time to\npaginate the\
-        \ results."
+        \ results. You can also use the page parameter to specify which set of `1000`\
+        \ results to return."
       operationId: ListEvents
       parameters:
       - description: POSIX timestamp.
@@ -12716,12 +13988,36 @@ paths:
           Otherwise if an event is aggregated to a parent event with a timestamp outside
           of the timeframe,
 
-          it won''t be available in the output.'
+          it won''t be available in the output. Aggregated events with `is_aggregate=true`
+          in the response will still be returned unless exclude_aggregate is set to
+          `true.`'
         in: query
         name: unaggregated
         required: false
         schema:
           type: boolean
+      - description: 'Set `exclude_aggregate` to `true` to only return unaggregated
+          events where `is_aggregate=false` in the response. If the `exclude_aggregate`
+          parameter is set to `true`,
+
+          then the unaggregated parameter is ignored and will be `true` by default.'
+        in: query
+        name: exclude_aggregate
+        required: false
+        schema:
+          type: boolean
+      - description: 'By default 1000 results are returned per request. Set page to
+          the number of the page to return with `0` being the first page. The page
+          parameter can only be used
+
+          when either unaggregated or exclude_aggregate is set to `true.`'
+        in: query
+        name: page
+        required: false
+        schema:
+          format: int32
+          maximum: 2147483647
+          type: integer
       responses:
         '200':
           content:
@@ -12744,6 +14040,7 @@ paths:
       summary: Query the event stream
       tags:
       - Events
+      x-menu-order: 1
       x-undo:
         type: safe
     post:
@@ -12777,6 +14074,7 @@ paths:
       tags:
       - Events
       x-codegen-request-body-name: body
+      x-menu-order: 1
       x-undo:
         type: safe
   /api/v1/events/{event_id}:
@@ -12815,6 +14113,7 @@ paths:
       summary: Get an event
       tags:
       - Events
+      x-menu-order: 2
       x-undo:
         type: safe
   /api/v1/graph/snapshot:
@@ -12889,6 +14188,7 @@ paths:
       summary: Take graph snapshots
       tags:
       - Snapshots
+      x-menu-order: 1
       x-undo:
         type: safe
   /api/v1/host/{host_name}/mute:
@@ -12932,6 +14232,7 @@ paths:
       tags:
       - Hosts
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: safe
   /api/v1/host/{host_name}/unmute:
@@ -12968,6 +14269,7 @@ paths:
       tags:
       - Hosts
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: safe
   /api/v1/hosts:
@@ -13057,6 +14359,7 @@ paths:
       summary: Get all hosts for your organization
       tags:
       - Hosts
+      x-menu-order: 1
       x-undo:
         type: safe
   /api/v1/hosts/totals:
@@ -13098,6 +14401,7 @@ paths:
       summary: Get the total number of active hosts
       tags:
       - Hosts
+      x-menu-order: 2
       x-undo:
         type: safe
   /api/v1/integration/aws:
@@ -13141,6 +14445,7 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-menu-order: 7
       x-undo:
         type: idempotent
     get:
@@ -13187,6 +14492,7 @@ paths:
       summary: List all AWS integrations
       tags:
       - AWS Integration
+      x-menu-order: 6
       x-undo:
         type: safe
     post:
@@ -13234,6 +14540,7 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-menu-order: 8
       x-undo:
         operationId: DeleteAWSAccount
         parameters: []
@@ -13300,6 +14607,7 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-menu-order: 9
       x-undo:
         type: safe
   /api/v1/integration/aws/available_namespace_rules:
@@ -13330,6 +14638,7 @@ paths:
       summary: List namespace rules
       tags:
       - AWS Integration
+      x-menu-order: 5
       x-undo:
         type: safe
   /api/v1/integration/aws/filtering:
@@ -13395,6 +14704,7 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: idempotent
     get:
@@ -13456,6 +14766,7 @@ paths:
       summary: Get all AWS tag filters
       tags:
       - AWS Integration
+      x-menu-order: 1
       x-undo:
         type: safe
     post:
@@ -13523,6 +14834,7 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         operationId: DeleteAWSTagFilter
         parameters: []
@@ -13566,6 +14878,7 @@ paths:
       tags:
       - AWS Integration
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/integration/aws/logs:
@@ -13603,6 +14916,7 @@ paths:
       tags:
       - AWS Logs Integration
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: idempotent
     get:
@@ -13643,6 +14957,7 @@ paths:
       summary: List all AWS Logs integrations
       tags:
       - AWS Logs Integration
+      x-menu-order: 1
       x-undo:
         type: safe
     post:
@@ -13679,6 +14994,7 @@ paths:
       tags:
       - AWS Logs Integration
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         operationId: DeleteAWSLambdaARN
         parameters: []
@@ -13733,6 +15049,7 @@ paths:
       tags:
       - AWS Logs Integration
       x-codegen-request-body-name: body
+      x-menu-order: 7
       x-undo:
         type: safe
   /api/v1/integration/aws/logs/services:
@@ -13772,6 +15089,7 @@ paths:
       summary: Get list of AWS log ready services
       tags:
       - AWS Logs Integration
+      x-menu-order: 4
       x-undo:
         type: safe
     post:
@@ -13808,6 +15126,7 @@ paths:
       tags:
       - AWS Logs Integration
       x-codegen-request-body-name: body
+      x-menu-order: 5
       x-undo:
         operationId: TODO
         type: unsafe
@@ -13852,6 +15171,7 @@ paths:
       tags:
       - AWS Logs Integration
       x-codegen-request-body-name: body
+      x-menu-order: 6
       x-undo:
         type: safe
   /api/v1/integration/azure:
@@ -13889,6 +15209,7 @@ paths:
       tags:
       - Azure Integration
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: idempotent
     get:
@@ -13917,6 +15238,7 @@ paths:
       summary: List all Azure integrations
       tags:
       - Azure Integration
+      x-menu-order: 1
       x-undo:
         type: safe
     post:
@@ -13966,6 +15288,7 @@ paths:
       tags:
       - Azure Integration
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         operationId: DeleteAzureIntegration
         parameters: []
@@ -14011,6 +15334,7 @@ paths:
       tags:
       - Azure Integration
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/integration/azure/host_filters:
@@ -14049,6 +15373,7 @@ paths:
       tags:
       - Azure Integration
       x-codegen-request-body-name: body
+      x-menu-order: 5
       x-undo:
         type: safe
   /api/v1/integration/gcp:
@@ -14086,6 +15411,7 @@ paths:
       tags:
       - GCP Integration
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: idempotent
     get:
@@ -14113,6 +15439,7 @@ paths:
       summary: List all GCP integrations
       tags:
       - GCP Integration
+      x-menu-order: 1
       x-undo:
         type: safe
     post:
@@ -14149,6 +15476,7 @@ paths:
       tags:
       - GCP Integration
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         operationId: DeleteGCPIntegration
         parameters: []
@@ -14194,6 +15522,7 @@ paths:
       tags:
       - GCP Integration
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/integration/pagerduty/configuration/services:
@@ -14230,6 +15559,7 @@ paths:
       tags:
       - PagerDuty Integration
       x-codegen-request-body-name: body
+      x-menu-order: 1
       x-undo:
         operationId: DeletePagerDutyIntegrationService
         parameters:
@@ -14265,6 +15595,7 @@ paths:
       summary: Delete a single service object
       tags:
       - PagerDuty Integration
+      x-menu-order: 4
       x-undo:
         type: idempotent
     get:
@@ -14299,6 +15630,7 @@ paths:
       summary: Get a single service object
       tags:
       - PagerDuty Integration
+      x-menu-order: 2
       x-undo:
         type: safe
     put:
@@ -14343,6 +15675,7 @@ paths:
       tags:
       - PagerDuty Integration
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: idempotent
   /api/v1/integration/slack/configuration/accounts/{account_name}/channels:
@@ -14379,6 +15712,7 @@ paths:
       summary: Get all channels in a Slack integration
       tags:
       - Slack Integration
+      x-menu-order: 1
       x-undo:
         type: safe
     post:
@@ -14422,6 +15756,7 @@ paths:
       tags:
       - Slack Integration
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         type: unsafe
   /api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}:
@@ -14455,6 +15790,7 @@ paths:
       summary: Remove a Slack integration channel
       tags:
       - Slack Integration
+      x-menu-order: 5
       x-undo:
         type: idempotent
     get:
@@ -14491,6 +15827,7 @@ paths:
       summary: Get a Slack integration channel
       tags:
       - Slack Integration
+      x-menu-order: 3
       x-undo:
         type: safe
     patch:
@@ -14535,6 +15872,7 @@ paths:
       tags:
       - Slack Integration
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/logs-queries/list:
@@ -14585,6 +15923,7 @@ paths:
       tags:
       - Logs
       x-codegen-request-body-name: body
+      x-menu-order: 1
       x-undo:
         type: safe
   /api/v1/logs/config/index-order:
@@ -14608,6 +15947,7 @@ paths:
       summary: Get indexes order
       tags:
       - Logs Indexes
+      x-menu-order: 5
       x-undo:
         type: safe
     put:
@@ -14646,6 +15986,7 @@ paths:
       tags:
       - Logs Indexes
       x-codegen-request-body-name: body
+      x-menu-order: 6
       x-undo:
         type: idempotent
   /api/v1/logs/config/indexes:
@@ -14670,6 +16011,7 @@ paths:
       summary: Get all indexes
       tags:
       - Logs Indexes
+      x-menu-order: 1
       x-undo:
         type: safe
     post:
@@ -14706,6 +16048,7 @@ paths:
       tags:
       - Logs Indexes
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         operationId: TODO
         parameters: []
@@ -14744,6 +16087,7 @@ paths:
       summary: Get an index
       tags:
       - Logs Indexes
+      x-menu-order: 3
       x-undo:
         type: safe
     put:
@@ -14795,6 +16139,7 @@ paths:
       tags:
       - Logs Indexes
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/logs/config/pipeline-order:
@@ -14819,6 +16164,7 @@ paths:
       summary: Get pipeline order
       tags:
       - Logs Pipelines
+      x-menu-order: 1
       x-undo:
         type: safe
     put:
@@ -14870,6 +16216,7 @@ paths:
       tags:
       - Logs Pipelines
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         type: idempotent
   /api/v1/logs/config/pipelines:
@@ -14894,6 +16241,7 @@ paths:
       summary: Get all pipelines
       tags:
       - Logs Pipelines
+      x-menu-order: 3
       x-undo:
         type: safe
     post:
@@ -14929,6 +16277,7 @@ paths:
       tags:
       - Logs Pipelines
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         operationId: DeleteLogsPipeline
         parameters:
@@ -14966,6 +16315,7 @@ paths:
       summary: Delete a pipeline
       tags:
       - Logs Pipelines
+      x-menu-order: 6
       x-undo:
         type: idempotent
     get:
@@ -15002,6 +16352,7 @@ paths:
       summary: Get a pipeline
       tags:
       - Logs Pipelines
+      x-menu-order: 5
       x-undo:
         type: safe
     put:
@@ -15047,6 +16398,7 @@ paths:
       tags:
       - Logs Pipelines
       x-codegen-request-body-name: body
+      x-menu-order: 7
       x-undo:
         type: idempotent
   /api/v1/metrics:
@@ -15102,6 +16454,7 @@ paths:
       summary: Get active metrics list
       tags:
       - Metrics
+      x-menu-order: 1
       x-undo:
         type: safe
   /api/v1/metrics/{metric_name}:
@@ -15137,6 +16490,7 @@ paths:
       summary: Get metric metadata
       tags:
       - Metrics
+      x-menu-order: 2
       x-undo:
         type: safe
     put:
@@ -15186,6 +16540,7 @@ paths:
       tags:
       - Metrics
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: idempotent
   /api/v1/monitor:
@@ -15284,6 +16639,7 @@ paths:
       summary: Get all monitor details
       tags:
       - Monitors
+      x-menu-order: 2
       x-undo:
         type: safe
     post:
@@ -15326,6 +16682,8 @@ paths:
 
         - rum: `rum alert`
 
+        - SLO: `slo alert`
+
         - watchdog: `event alert`
 
         - event-v2: `event-v2 alert`
@@ -15530,7 +16888,22 @@ paths:
         to filter results by these tags.
 
         It is only available via the API and isn''t visible or editable in the Datadog
-        UI.'
+        UI.
+
+
+        **SLO Alert Query**
+
+
+        Example: `error_budget("slo_id").over("time_window") operator #`
+
+
+        - **`slo_id`**: The alphanumeric SLO ID of the SLO you are configuring the
+        alert for.
+
+        - **`time_window`**: The time window of the SLO target you wish to alert on.
+        Valid options: `7d`, `30d`, `90d`.
+
+        - **`operator`**: `>=` or `>`'
       operationId: CreateMonitor
       requestBody:
         content:
@@ -15562,6 +16935,7 @@ paths:
       tags:
       - Monitors
       x-codegen-request-body-name: body
+      x-menu-order: 1
       x-undo:
         operationId: DeleteMonitor
         parameters:
@@ -15610,6 +16984,7 @@ paths:
       summary: Check if a monitor can be deleted
       tags:
       - Monitors
+      x-menu-order: 6
       x-undo:
         type: safe
   /api/v1/monitor/validate:
@@ -15646,6 +17021,7 @@ paths:
       tags:
       - Monitors
       x-codegen-request-body-name: body
+      x-menu-order: 7
       x-undo:
         type: idempotent
   /api/v1/monitor/{monitor_id}:
@@ -15701,6 +17077,7 @@ paths:
       summary: Delete a monitor
       tags:
       - Monitors
+      x-menu-order: 5
       x-undo:
         type: idempotent
     get:
@@ -15749,6 +17126,7 @@ paths:
       summary: Get a monitor's details
       tags:
       - Monitors
+      x-menu-order: 4
       x-undo:
         type: safe
     put:
@@ -15804,6 +17182,7 @@ paths:
       tags:
       - Monitors
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: idempotent
   /api/v1/monitor/{monitor_id}/downtimes:
@@ -15838,110 +17217,395 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Monitor Not Found error
-      summary: Get all downtimes for a monitor
+          description: Monitor Not Found error
+      summary: Get all downtimes for a monitor
+      tags:
+      - Downtimes
+      x-codegen-request-body-name: body
+      x-menu-order: 7
+      x-undo:
+        type: safe
+  /api/v1/monthly_custom_reports:
+    get:
+      description: Get monthly custom reports.
+      operationId: GetMonthlyCustomReports
+      parameters:
+      - description: The number of files to return in the response `[default=60].`
+        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
+      - description: 'The direction to sort by: `[desc, asc]`.'
+        in: query
+        name: sort_dir
+        required: false
+        schema:
+          $ref: '#/components/schemas/UsageSortDirection'
+      - description: 'The field to sort by: `[computed_on, size, start_date, end_date]`.'
+        in: query
+        name: sort
+        required: false
+        schema:
+          $ref: '#/components/schemas/UsageSort'
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/UsageCustomReportsResponse'
+          description: OK
+        '403':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden - User is not authorized
+      summary: Get the list of available monthly custom reports
+      tags:
+      - Usage Metering
+      x-menu-order: 22
+      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/monthly_custom_reports/{report_id}:
+    get:
+      description: Get specified monthly custom reports.
+      operationId: GetSpecifiedMonthlyCustomReports
+      parameters:
+      - description: The specified ID to search results for.
+        in: path
+        name: report_id
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/UsageSpecifiedCustomReportsResponse'
+          description: OK
+        '400':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden - User is not authorized
+        '404':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+      summary: Get specified monthly custom reports
+      tags:
+      - Usage Metering
+      x-menu-order: 23
+      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/notebooks:
+    get:
+      description: 'Get all notebooks. This can also be used to search for notebooks
+        with a particular `query` in the notebook
+
+        `name` or author `handle`.'
+      operationId: ListNotebooks
+      parameters:
+      - description: Return notebooks created by the given `author_handle`.
+        in: query
+        name: author_handle
+        required: false
+        schema:
+          example: test@datadoghq.com
+          type: string
+        style: form
+      - description: Return notebooks not created by the given `author_handle`.
+        in: query
+        name: exclude_author_handle
+        required: false
+        schema:
+          example: test@datadoghq.com
+          type: string
+        style: form
+      - description: The index of the first notebook you want returned.
+        in: query
+        name: start
+        required: false
+        schema:
+          example: 0
+          format: int64
+          type: integer
+        style: form
+      - description: The number of notebooks to be returned.
+        in: query
+        name: count
+        required: false
+        schema:
+          example: 5
+          format: int64
+          type: integer
+        style: form
+      - description: Sort by field `modified` or `name`.
+        in: query
+        name: sort_field
+        required: false
+        schema:
+          default: modified
+          example: modified
+          type: string
+        style: form
+      - description: Sort by direction `asc` or `desc`.
+        in: query
+        name: sort_dir
+        required: false
+        schema:
+          default: desc
+          example: desc
+          type: string
+        style: form
+      - description: Return only notebooks with `query` string in notebook name or
+          author handle.
+        in: query
+        name: query
+        required: false
+        schema:
+          example: postmortem
+          type: string
+        style: form
+      - description: Value of `false` excludes the `cells` and global `time` for each
+          notebook.
+        in: query
+        name: include_cells
+        required: false
+        schema:
+          default: true
+          example: false
+          type: boolean
+        style: form
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotebooksResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+      summary: Get all notebooks
+      tags:
+      - Notebooks
+      x-undo:
+        type: safe
+    post:
+      description: Create a notebook using the specified options.
+      operationId: CreateNotebook
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/NotebookCreateRequest'
+        description: The JSON description of the notebook you want to create.
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotebookResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+      summary: Create a notebook
+      tags:
+      - Notebooks
+      x-codegen-request-body-name: body
+      x-given:
+        notebook:
+          parameters:
+          - file: notebook_payload.json
+            name: body
+          step: there is a valid "notebook" in the system
+      x-undo:
+        operationId: DeleteNotebook
+        parameters:
+        - name: notebook_id
+          source: data.id
+        type: unsafe
+  /api/v1/notebooks/{notebook_id}:
+    delete:
+      description: Delete a notebook using the specified ID.
+      operationId: DeleteNotebook
+      parameters:
+      - description: Unique ID, assigned when you create the notebook.
+        in: path
+        name: notebook_id
+        required: true
+        schema:
+          format: int64
+          type: integer
+      responses:
+        '204':
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication Error
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+      summary: Delete a notebook
       tags:
-      - Downtimes
-      x-codegen-request-body-name: body
+      - Notebooks
       x-undo:
-        type: safe
-  /api/v1/monthly_custom_reports:
+        type: idempotent
     get:
-      description: Get monthly custom reports.
-      operationId: GetMonthlyCustomReports
+      description: Get a notebook using the specified notebook ID.
+      operationId: GetNotebook
       parameters:
-      - description: The number of files to return in the response `[default=60].`
-        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
+      - description: Unique ID, assigned when you create the notebook.
+        in: path
+        name: notebook_id
+        required: true
         schema:
           format: int64
           type: integer
-      - description: 'The direction to sort by: `[desc, asc]`.'
-        in: query
-        name: sort_dir
-        required: false
-        schema:
-          $ref: '#/components/schemas/UsageSortDirection'
-      - description: 'The field to sort by: `[computed_on, size, start_date, end_date]`.'
-        in: query
-        name: sort
-        required: false
-        schema:
-          $ref: '#/components/schemas/UsageSort'
       responses:
         '200':
           content:
-            application/json;datetime-format=rfc3339:
+            application/json:
               schema:
-                $ref: '#/components/schemas/UsageCustomReportsResponse'
+                $ref: '#/components/schemas/NotebookResponse'
           description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
         '403':
           content:
-            application/json;datetime-format=rfc3339:
+            application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Forbidden - User is not authorized
-      summary: Get the list of available monthly custom reports
+          description: Authentication Error
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+      summary: Get a notebook
       tags:
-      - Usage Metering
+      - Notebooks
       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/monthly_custom_reports/{report_id}:
-    get:
-      description: Get specified monthly custom reports.
-      operationId: GetSpecifiedMonthlyCustomReports
+    put:
+      description: Update a notebook using the specified ID.
+      operationId: UpdateNotebook
       parameters:
-      - description: The specified ID to search results for.
+      - description: Unique ID, assigned when you create the notebook.
         in: path
-        name: report_id
+        name: notebook_id
         required: true
         schema:
-          type: string
+          format: int64
+          type: integer
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/NotebookUpdateRequest'
+        description: Update notebook request body.
+        required: true
       responses:
         '200':
           content:
-            application/json;datetime-format=rfc3339:
+            application/json:
               schema:
-                $ref: '#/components/schemas/UsageSpecifiedCustomReportsResponse'
+                $ref: '#/components/schemas/NotebookResponse'
           description: OK
         '400':
           content:
-            application/json;datetime-format=rfc3339:
+            application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
           description: Bad Request
         '403':
           content:
-            application/json;datetime-format=rfc3339:
+            application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Forbidden - User is not authorized
+          description: Authentication Error
         '404':
           content:
-            application/json;datetime-format=rfc3339:
+            application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
           description: Not Found
-      summary: Get specified monthly custom reports
+        '409':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Conflict
+      summary: Update a notebook
       tags:
-      - Usage Metering
+      - Notebooks
+      x-codegen-request-body-name: body
       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/).'
+        type: idempotent
   /api/v1/org:
     get:
       description: List your managed organizations.
@@ -15962,6 +17626,7 @@ paths:
       summary: List your managed organizations
       tags:
       - Organizations
+      x-menu-order: 2
       x-undo:
         type: safe
     post:
@@ -16013,6 +17678,7 @@ paths:
       tags:
       - Organizations
       x-codegen-request-body-name: body
+      x-menu-order: 1
       x-undo:
         operationId: TODO
         parameters: []
@@ -16051,6 +17717,7 @@ paths:
       summary: Get organization information
       tags:
       - Organizations
+      x-menu-order: 3
       x-undo:
         type: safe
     put:
@@ -16093,6 +17760,7 @@ paths:
       tags:
       - Organizations
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/org/{public_id}/idp_metadata:
@@ -16151,6 +17819,7 @@ paths:
       tags:
       - Organizations
       x-codegen-request-body-name: body
+      x-menu-order: 5
       x-undo:
         type: safe
   /api/v1/query:
@@ -16200,6 +17869,7 @@ paths:
       summary: Query timeseries points
       tags:
       - Metrics
+      x-menu-order: 5
       x-undo:
         type: safe
   /api/v1/search:
@@ -16235,6 +17905,7 @@ paths:
       summary: Search metrics
       tags:
       - Metrics
+      x-menu-order: 4
       x-undo:
         type: safe
   /api/v1/series:
@@ -16304,6 +17975,7 @@ paths:
       tags:
       - Metrics
       x-codegen-request-body-name: body
+      x-menu-order: 1
       x-undo:
         type: safe
   /api/v1/slo:
@@ -16369,6 +18041,7 @@ paths:
       summary: Get all SLOs
       tags:
       - Service Level Objectives
+      x-menu-order: 2
       x-undo:
         type: safe
     post:
@@ -16414,6 +18087,7 @@ paths:
               sum:httpservice.hits{code:2xx}.as_count()\",\n    \"denominator\": \"\
               sum:httpservice.hits{!code:3xx}.as_count()\"\n  }\n}"
           step: there is a valid "slo" in the system
+      x-menu-order: 1
       x-undo:
         operationId: DeleteSLO
         parameters:
@@ -16463,6 +18137,7 @@ paths:
       tags:
       - Service Level Objectives
       x-codegen-request-body-name: body
+      x-menu-order: 8
       x-undo:
         type: idempotent
   /api/v1/slo/can_delete:
@@ -16508,6 +18183,7 @@ paths:
       summary: Check if SLOs can be safely deleted
       tags:
       - Service Level Objectives
+      x-menu-order: 7
       x-undo:
         type: safe
   /api/v1/slo/correction:
@@ -16530,6 +18206,7 @@ paths:
       summary: Get all SLO corrections
       tags:
       - Service Level Objective Corrections
+      x-menu-order: 2
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -16564,6 +18241,12 @@ paths:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
           description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: SLO Not Found
       summary: Create an SLO correction
       tags:
       - Service Level Objective Corrections
@@ -16572,12 +18255,13 @@ paths:
         correction:
           parameters:
           - name: body
-            value: "{\n  \"data\": {\n    \"id\": \"1\",\n    \"attributes\": {\n\
-              \      \"slo_id\": \"{{ slo.data[0].id }}\",\n      \"start\": {{ now_ts\
-              \ }},\n      \"end\": {{ hour_later_ts }},\n      \"category\": \"Other\"\
-              ,\n      \"timezone\": \"UTC\",\n      \"description\": \"Test Correction\"\
-              \n     },\n     \"type\": \"correction\"\n  }\n}"
+            value: "{\n  \"data\": {\n    \"attributes\": {\n      \"slo_id\": \"\
+              {{ slo.data[0].id }}\",\n      \"start\": {{ now_ts }},\n      \"end\"\
+              : {{ hour_later_ts }},\n      \"category\": \"Other\",\n      \"timezone\"\
+              : \"UTC\",\n      \"description\": \"Test Correction\"\n     },\n  \
+              \   \"type\": \"correction\"\n  }\n}"
           step: there is a valid "correction" for "slo"
+      x-menu-order: 1
       x-undo:
         operationId: DeleteSLOCorrection
         parameters:
@@ -16616,6 +18300,7 @@ paths:
       summary: Delete an SLO correction
       tags:
       - Service Level Objective Corrections
+      x-menu-order: 5
       x-undo:
         type: idempotent
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -16653,6 +18338,7 @@ paths:
       summary: Get an SLO correction for an SLO
       tags:
       - Service Level Objective Corrections
+      x-menu-order: 3
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -16704,6 +18390,7 @@ paths:
       tags:
       - Service Level Objective Corrections
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -16760,6 +18447,7 @@ paths:
       summary: Delete an SLO
       tags:
       - Service Level Objectives
+      x-menu-order: 5
       x-undo:
         type: idempotent
     get:
@@ -16772,6 +18460,13 @@ paths:
         required: true
         schema:
           type: string
+      - description: Get the IDs of SLO monitors that reference this SLO.
+        example: true
+        in: query
+        name: with_configured_alert_ids
+        required: false
+        schema:
+          type: boolean
       responses:
         '200':
           content:
@@ -16794,6 +18489,7 @@ paths:
       summary: Get an SLO's details
       tags:
       - Service Level Objectives
+      x-menu-order: 4
       x-undo:
         type: safe
     put:
@@ -16842,6 +18538,7 @@ paths:
       tags:
       - Service Level Objectives
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: idempotent
   /api/v1/slo/{slo_id}/history:
@@ -16913,6 +18610,7 @@ paths:
       summary: Get an SLO's history
       tags:
       - Service Level Objectives
+      x-menu-order: 6
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -16934,6 +18632,7 @@ paths:
       summary: Get all locations (public and private)
       tags:
       - Synthetics
+      x-menu-order: 22
       x-undo:
         type: safe
   /api/v1/synthetics/private-locations:
@@ -16970,6 +18669,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 19
       x-undo:
         operationId: DeletePrivateLocation
         parameters:
@@ -17001,6 +18701,7 @@ paths:
       summary: Delete a private location
       tags:
       - Synthetics
+      x-menu-order: 23
       x-undo:
         type: idempotent
     get:
@@ -17031,6 +18732,7 @@ paths:
       summary: Get a private location
       tags:
       - Synthetics
+      x-menu-order: 21
       x-undo:
         type: safe
     put:
@@ -17069,6 +18771,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 20
       x-undo:
         type: idempotent
   /api/v1/synthetics/tests:
@@ -17097,54 +18800,9 @@ paths:
       summary: Get the list of all tests
       tags:
       - Synthetics
+      x-menu-order: 9
       x-undo:
         type: safe
-    post:
-      deprecated: true
-      description: Create a Synthetic test.
-      operationId: CreateTest
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/SyntheticsTestDetails'
-        description: Details of the test to create.
-        required: true
-      responses:
-        '200':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/SyntheticsTestDetails'
-          description: OK - Returns the created test details.
-        '400':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/APIErrorResponse'
-          description: '- JSON format is wrong
-
-            - Creation failed'
-        '402':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/APIErrorResponse'
-          description: Test quota is reached
-        '403':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/APIErrorResponse'
-          description: Forbidden
-      summary: Create a test
-      tags:
-      - Synthetics
-      x-codegen-request-body-name: body
-      x-undo:
-        operationId: TODO
-        parameters: []
-        type: unsafe
   /api/v1/synthetics/tests/api:
     post:
       description: Create a Synthetic API test.
@@ -17187,6 +18845,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 1
       x-undo:
         operationId: TODO
         parameters: []
@@ -17228,6 +18887,7 @@ paths:
       summary: Get an API test
       tags:
       - Synthetics
+      x-menu-order: 7
       x-undo:
         type: safe
     put:
@@ -17282,6 +18942,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         type: idempotent
   /api/v1/synthetics/tests/browser:
@@ -17326,6 +18987,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 2
       x-undo:
         operationId: TODO
         parameters: []
@@ -17364,9 +19026,10 @@ paths:
           description: '- Synthetic is not activated for the user
 
             - Test is not owned by the user'
-      summary: Get a test configuration (browser)
+      summary: Get a browser test
       tags:
       - Synthetics
+      x-menu-order: 8
       x-undo:
         type: safe
     put:
@@ -17421,6 +19084,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/synthetics/tests/browser/{public_id}/results:
@@ -17480,10 +19144,11 @@ paths:
           description: '- Synthetic is not activated for the user
 
             - Test is not owned by the user'
-      summary: Get the test's latest results summaries (browser)
+      summary: Get a browser test's latest results summaries
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 13
       x-undo:
         type: safe
   /api/v1/synthetics/tests/browser/{public_id}/results/{result_id}:
@@ -17526,9 +19191,10 @@ paths:
           description: '- Synthetic is not activated for the user
 
             - Test or result is not owned by the user'
-      summary: Get a test result (browser)
+      summary: Get a browser test result
       tags:
       - Synthetics
+      x-menu-order: 11
       x-undo:
         type: safe
   /api/v1/synthetics/tests/delete:
@@ -17578,6 +19244,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 14
       x-undo:
         type: idempotent
   /api/v1/synthetics/tests/trigger/ci:
@@ -17604,10 +19271,11 @@ paths:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
           description: JSON format is wrong
-      summary: Trigger some Synthetics tests for CI
+      summary: Trigger tests from CI/CD pipelines
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 6
       x-undo:
         type: idempotent
   /api/v1/synthetics/tests/{public_id}:
@@ -17642,66 +19310,12 @@ paths:
           description: '- Synthetic is not activated for the user
 
             - Test is not owned by the user'
-      summary: Get a test configuration (API)
+      summary: Get a test configuration
       tags:
       - Synthetics
+      x-menu-order: 24
       x-undo:
         type: safe
-    put:
-      deprecated: true
-      description: Edit the configuration of a Synthetic test.
-      operationId: UpdateTest
-      parameters:
-      - description: The public ID of the test to get details from.
-        in: path
-        name: public_id
-        required: true
-        schema:
-          type: string
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/SyntheticsTestDetails'
-        description: New test details to be saved.
-        required: true
-      responses:
-        '200':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/SyntheticsTestDetails'
-          description: OK
-        '400':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/APIErrorResponse'
-          description: '- JSON format is wrong
-
-            - Updating sub-type is forbidden'
-        '403':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/APIErrorResponse'
-          description: Forbidden
-        '404':
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
-
-            - Test is not owned by the user
-
-            - Test can''t be found'
-      summary: Edit a test
-      tags:
-      - Synthetics
-      x-codegen-request-body-name: body
-      x-undo:
-        type: idempotent
   /api/v1/synthetics/tests/{public_id}/results:
     get:
       description: Get the last 50 test results summaries for a given Synthetics API
@@ -17757,10 +19371,11 @@ paths:
           description: '- Synthetic is not activated for the user
 
             - Test is not owned by the user'
-      summary: Get the test's latest results summaries (API)
+      summary: Get an API test's latest results summaries
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 12
       x-undo:
         type: safe
   /api/v1/synthetics/tests/{public_id}/results/{result_id}:
@@ -17801,9 +19416,10 @@ paths:
           description: '- Synthetic is not activated for the user
 
             - Test or result is not owned by the user'
-      summary: Get a test result (API)
+      summary: Get an API test result
       tags:
       - Synthetics
+      x-menu-order: 10
       x-undo:
         type: safe
   /api/v1/synthetics/tests/{public_id}/status:
@@ -17855,6 +19471,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 5
       x-undo:
         type: idempotent
   /api/v1/synthetics/variables:
@@ -17891,6 +19508,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 15
       x-undo:
         operationId: DeleteGlobalVariable
         parameters:
@@ -17932,6 +19550,7 @@ paths:
       summary: Delete a global variable
       tags:
       - Synthetics
+      x-menu-order: 18
       x-undo:
         type: idempotent
     get:
@@ -17966,6 +19585,7 @@ paths:
       summary: Get a global variable
       tags:
       - Synthetics
+      x-menu-order: 17
       x-undo:
         type: safe
     put:
@@ -18008,6 +19628,7 @@ paths:
       tags:
       - Synthetics
       x-codegen-request-body-name: body
+      x-menu-order: 16
       x-undo:
         type: idempotent
   /api/v1/tags/hosts:
@@ -18044,6 +19665,7 @@ paths:
       summary: Get Tags
       tags:
       - Tags
+      x-menu-order: 1
       x-undo:
         type: safe
   /api/v1/tags/hosts/{host_name}:
@@ -18086,6 +19708,7 @@ paths:
       summary: Remove host tags
       tags:
       - Tags
+      x-menu-order: 5
       x-undo:
         type: idempotent
     get:
@@ -18127,6 +19750,7 @@ paths:
       summary: Get host tags
       tags:
       - Tags
+      x-menu-order: 2
       x-undo:
         type: safe
     post:
@@ -18181,6 +19805,7 @@ paths:
       tags:
       - Tags
       x-codegen-request-body-name: body
+      x-menu-order: 3
       x-undo:
         operationId: DeleteHostTags
         parameters:
@@ -18240,6 +19865,7 @@ paths:
       tags:
       - Tags
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/usage/analyzed_logs:
@@ -18287,6 +19913,7 @@ paths:
       summary: Get hourly usage for analyzed logs
       tags:
       - Usage Metering
+      x-menu-order: 17
       x-undo:
         type: safe
   /api/v1/usage/attribution:
@@ -18304,12 +19931,13 @@ paths:
         schema:
           format: date-time
           type: string
-      - description: The specified field to search results for.
+      - description: Comma-separated list of usage types to return, or `*` for all
+          usage types.
         in: query
         name: fields
         required: true
         schema:
-          type: string
+          $ref: '#/components/schemas/UsageAttributionSupportedMetrics'
       - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`
           for usage ending this month.'
         in: query
@@ -18346,6 +19974,7 @@ paths:
       summary: Get Usage Attribution
       tags:
       - Usage Metering
+      x-menu-order: 29
       x-undo:
         type: safe
       x-unstable: '**Note**: This endpoint is in public beta.
@@ -18394,6 +20023,7 @@ paths:
       summary: Get hourly usage for Lambda
       tags:
       - Usage Metering
+      x-menu-order: 12
       x-undo:
         type: safe
   /api/v1/usage/billable-summary:
@@ -18431,6 +20061,7 @@ paths:
       summary: Get billable usage across your account
       tags:
       - Usage Metering
+      x-menu-order: 19
       x-undo:
         type: safe
   /api/v1/usage/compliance-monitoring:
@@ -18478,6 +20109,7 @@ paths:
       summary: Get hourly usage for Compliance Monitoring
       tags:
       - Usage Metering
+      x-menu-order: 30
       x-undo:
         type: safe
   /api/v1/usage/fargate:
@@ -18523,6 +20155,7 @@ paths:
       summary: Get hourly usage for Fargate
       tags:
       - Usage Metering
+      x-menu-order: 11
       x-undo:
         type: safe
   /api/v1/usage/hosts:
@@ -18568,6 +20201,7 @@ paths:
       summary: Get hourly usage for hosts and containers
       tags:
       - Usage Metering
+      x-menu-order: 1
       x-undo:
         type: safe
   /api/v1/usage/incident-management:
@@ -18615,6 +20249,7 @@ paths:
       summary: Get hourly usage for incident management
       tags:
       - Usage Metering
+      x-menu-order: 27
       x-undo:
         type: safe
   /api/v1/usage/indexed-spans:
@@ -18660,6 +20295,7 @@ paths:
       summary: Get hourly usage for indexed spans
       tags:
       - Usage Metering
+      x-menu-order: 7
       x-undo:
         type: safe
   /api/v1/usage/ingested-spans:
@@ -18707,6 +20343,7 @@ paths:
       summary: Get hourly usage for ingested spans
       tags:
       - Usage Metering
+      x-menu-order: 26
       x-undo:
         type: safe
   /api/v1/usage/iot:
@@ -18754,6 +20391,7 @@ paths:
       summary: Get hourly usage for IoT
       tags:
       - Usage Metering
+      x-menu-order: 28
       x-undo:
         type: safe
   /api/v1/usage/logs:
@@ -18799,6 +20437,54 @@ paths:
       summary: Get hourly usage for Logs
       tags:
       - Usage Metering
+      x-menu-order: 2
+      x-undo:
+        type: safe
+  /api/v1/usage/logs-by-retention:
+    get:
+      description: Get hourly usage for indexed logs by retention period.
+      operationId: GetUsageLogsByRetention
+      parameters:
+      - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
+          for usage beginning at this hour.'
+        in: query
+        name: start_hr
+        required: true
+        schema:
+          format: date-time
+          type: string
+      - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
+          for usage ending
+
+          **before** this hour.'
+        in: query
+        name: end_hr
+        required: false
+        schema:
+          format: date-time
+          type: string
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/UsageLogsByRetentionResponse'
+          description: OK
+        '400':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden - User is not authorized
+      summary: Get hourly logs usage by retention
+      tags:
+      - Usage Metering
       x-undo:
         type: safe
   /api/v1/usage/logs_by_index:
@@ -18852,6 +20538,7 @@ paths:
       summary: Get hourly usage for Logs by Index
       tags:
       - Usage Metering
+      x-menu-order: 3
       x-undo:
         type: safe
   /api/v1/usage/network_flows:
@@ -18899,6 +20586,7 @@ paths:
       summary: Get hourly usage for Network Flows
       tags:
       - Usage Metering
+      x-menu-order: 15
       x-undo:
         type: safe
   /api/v1/usage/network_hosts:
@@ -18944,6 +20632,7 @@ paths:
       summary: Get hourly usage for Network Hosts
       tags:
       - Usage Metering
+      x-menu-order: 14
       x-undo:
         type: safe
   /api/v1/usage/profiling:
@@ -18991,6 +20680,7 @@ paths:
       summary: Get hourly usage for profiled hosts
       tags:
       - Usage Metering
+      x-menu-order: 24
       x-undo:
         type: safe
   /api/v1/usage/rum_sessions:
@@ -19043,6 +20733,7 @@ paths:
       summary: Get hourly usage for RUM Sessions
       tags:
       - Usage Metering
+      x-menu-order: 13
       x-undo:
         type: safe
   /api/v1/usage/snmp:
@@ -19090,6 +20781,7 @@ paths:
       summary: Get hourly usage for SNMP devices
       tags:
       - Usage Metering
+      x-menu-order: 18
       x-undo:
         type: safe
   /api/v1/usage/summary:
@@ -19144,6 +20836,7 @@ paths:
       summary: Get usage across your multi-org account
       tags:
       - Usage Metering
+      x-menu-order: 16
       x-undo:
         type: safe
   /api/v1/usage/synthetics:
@@ -19190,6 +20883,7 @@ paths:
       summary: Get hourly usage for Synthetics Checks
       tags:
       - Usage Metering
+      x-menu-order: 8
       x-undo:
         type: safe
   /api/v1/usage/synthetics_api:
@@ -19235,6 +20929,7 @@ paths:
       summary: Get hourly usage for Synthetics API Checks
       tags:
       - Usage Metering
+      x-menu-order: 9
       x-undo:
         type: safe
   /api/v1/usage/synthetics_browser:
@@ -19280,6 +20975,7 @@ paths:
       summary: Get hourly usage for Synthetics Browser Checks
       tags:
       - Usage Metering
+      x-menu-order: 10
       x-undo:
         type: safe
   /api/v1/usage/timeseries:
@@ -19325,6 +21021,7 @@ paths:
       summary: Get hourly usage for custom metrics
       tags:
       - Usage Metering
+      x-menu-order: 4
       x-undo:
         type: safe
   /api/v1/usage/top_avg_metrics:
@@ -19392,6 +21089,7 @@ paths:
       summary: Get top custom metrics by hourly average
       tags:
       - Usage Metering
+      x-menu-order: 5
       x-undo:
         type: safe
   /api/v1/usage/traces:
@@ -19441,6 +21139,7 @@ paths:
       summary: Get hourly usage for Trace Search
       tags:
       - Usage Metering
+      x-menu-order: 6
       x-undo:
         type: safe
   /api/v1/usage/tracing-without-limits:
@@ -19492,6 +21191,7 @@ paths:
       summary: Get hourly usage for tracing without limits
       tags:
       - Usage Metering
+      x-menu-order: 25
       x-undo:
         type: safe
   /api/v1/user:
@@ -19514,6 +21214,7 @@ paths:
       summary: List all users
       tags:
       - Users
+      x-menu-order: 2
       x-undo:
         type: safe
     post:
@@ -19560,6 +21261,7 @@ paths:
       tags:
       - Users
       x-codegen-request-body-name: body
+      x-menu-order: 1
       x-undo:
         operationId: DisableUser
         parameters:
@@ -19612,6 +21314,7 @@ paths:
       summary: Disable a user
       tags:
       - Users
+      x-menu-order: 5
       x-undo:
         type: idempotent
     get:
@@ -19648,6 +21351,7 @@ paths:
       summary: Get user details
       tags:
       - Users
+      x-menu-order: 3
       x-undo:
         type: safe
     put:
@@ -19701,6 +21405,7 @@ paths:
       tags:
       - Users
       x-codegen-request-body-name: body
+      x-menu-order: 4
       x-undo:
         type: idempotent
   /api/v1/validate:
@@ -19726,6 +21431,7 @@ paths:
       summary: Validate API key
       tags:
       - Authentication
+      x-menu-order: 1
       x-undo:
         type: safe
   /v1/input:
@@ -19887,6 +21593,7 @@ paths:
       tags:
       - Logs
       x-codegen-request-body-name: body
+      x-menu-order: 1
       x-undo:
         type: safe
 security:
@@ -20047,6 +21754,17 @@ tags:
     description: Find out more at
     url: https://docs.datadoghq.com/monitors/monitor_types/
   name: Monitors
+- description: 'Interact with your notebooks through the API to make it easier to
+    organize, find, and
+
+    share all of your notebooks with your team and organization. For more information,
+    see the
+
+    [Notebooks documentation](https://docs.datadoghq.com/notebooks/).'
+  externalDocs:
+    description: For more information, see the Notebooks documentation.
+    url: https://docs.datadoghq.com/notebooks/
+  name: Notebooks
 - description: Create, edit, and manage your organizations. Read more about [multi-org
     accounts](https://docs.datadoghq.com/account_management/multi_organization).
   externalDocs: