datadog_api_client 2.23.0 → 2.24.0

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

@@ -2197,7 +2197,7 @@ components:
           description: 'POSIX timestamp of the event. Must be sent as an integer (that
             is no quotes).
 
-            Limited to events no older than 18 hours.'
+            Limited to events up to 18 hours in the past and two hours in the future.'
           format: int64
           type: integer
         device_name:
@@ -3043,6 +3043,14 @@ components:
       type: string
       x-enum-varnames:
       - METRIC
+    FormulaType:
+      description: Set the sort type to formula.
+      enum:
+      - formula
+      example: formula
+      type: string
+      x-enum-varnames:
+      - FORMULA
     FreeTextWidgetDefinition:
       description: Free text is a widget that allows you to add headings to your screenboard.
         Commonly used to state the overall purpose of the dashboard. Only available
@@ -3411,6 +3419,8 @@ components:
           $ref: '#/components/schemas/LogQueryDefinition'
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+        sort:
+          $ref: '#/components/schemas/WidgetSortBy'
       type: object
     GraphSnapshot:
       description: Object representing a graph snapshot.
@@ -3431,6 +3441,14 @@ components:
           example: https://app.datadoghq.com/s/f12345678/aaa-bbb-ccc
           type: string
       type: object
+    GroupType:
+      description: Set the sort type to group.
+      enum:
+      - group
+      example: group
+      type: string
+      x-enum-varnames:
+      - GROUP
     GroupWidgetDefinition:
       description: The groups widget allows you to keep similar graphs together on
         your timeboard. Each group has a custom header, can hold one to many graphs,
@@ -6597,8 +6615,6 @@ components:
         priority:
           description: Integer from 1 (high) to 5 (low) indicating alert severity.
           format: int64
-          maximum: 5
-          minimum: 1
           nullable: true
           type: integer
         query:
@@ -7687,8 +7703,7 @@ components:
         priority:
           description: Integer from 1 (high) to 5 (low) indicating alert severity.
           format: int64
-          maximum: 5
-          minimum: 1
+          nullable: true
           type: integer
         query:
           description: The monitor query.
@@ -8553,11 +8568,11 @@ components:
           format: double
           type: number
         rum_replay_sessions_percentage:
-          description: The percentage of RUM Replay Sessions usage by tag(s).
+          description: The percentage of RUM Session Replay usage by tag(s).
           format: double
           type: number
         rum_replay_sessions_usage:
-          description: The total RUM Replay Sessions usage by tag(s).
+          description: The total RUM Session Replay usage by tag(s).
           format: double
           type: number
         sds_scanned_bytes_percentage:
@@ -13351,60 +13366,11 @@ components:
           $ref: '#/components/schemas/WidgetStyle'
       type: object
     SyntheticsAPIStep:
-      description: The steps used in a Synthetic 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.
-          example:
-          - operator: lessThan
-            target: 1000
-            type: responseTime
-          items:
-            $ref: '#/components/schemas/SyntheticsAssertion'
-          type: array
-        extractedValues:
-          description: Array of values to parse and save as variables from the response.
-          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.
-          example: Example step name
-          type: string
-        request:
-          $ref: '#/components/schemas/SyntheticsTestRequest'
-        retry:
-          $ref: '#/components/schemas/SyntheticsTestOptionsRetry'
-        subtype:
-          $ref: '#/components/schemas/SyntheticsAPIStepSubtype'
-      required:
-      - assertions
-      - request
-      - name
-      - subtype
+      description: The steps used in a Synthetic multi-step API test.
+      oneOf:
+      - $ref: '#/components/schemas/SyntheticsAPITestStep'
+      - $ref: '#/components/schemas/SyntheticsAPIWaitStep'
       type: object
-    SyntheticsAPIStepSubtype:
-      description: The subtype of the Synthetic multistep API test step, currently
-        only supporting `http`.
-      enum:
-      - http
-      - grpc
-      example: http
-      type: string
-      x-enum-varnames:
-      - HTTP
-      - GRPC
     SyntheticsAPITest:
       description: Object containing details about a Synthetic API test.
       properties:
@@ -13593,6 +13559,60 @@ components:
         timings:
           $ref: '#/components/schemas/SyntheticsTiming'
       type: object
+    SyntheticsAPITestStep:
+      description: The Test step used in a Synthetic multi-step 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.
+          example:
+          - operator: lessThan
+            target: 1000
+            type: responseTime
+          items:
+            $ref: '#/components/schemas/SyntheticsAssertion'
+          type: array
+        extractedValues:
+          description: Array of values to parse and save as variables from the response.
+          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.
+          example: Example step name
+          type: string
+        request:
+          $ref: '#/components/schemas/SyntheticsTestRequest'
+        retry:
+          $ref: '#/components/schemas/SyntheticsTestOptionsRetry'
+        subtype:
+          $ref: '#/components/schemas/SyntheticsAPITestStepSubtype'
+      required:
+      - assertions
+      - request
+      - name
+      - subtype
+      type: object
+    SyntheticsAPITestStepSubtype:
+      description: The subtype of the Synthetic multi-step API test step.
+      enum:
+      - http
+      - grpc
+      example: http
+      type: string
+      x-enum-varnames:
+      - HTTP
+      - GRPC
     SyntheticsAPITestType:
       default: api
       description: Type of the Synthetic test, `api`.
@@ -13602,6 +13622,36 @@ components:
       type: string
       x-enum-varnames:
       - API
+    SyntheticsAPIWaitStep:
+      description: The Wait step used in a Synthetic multi-step API test.
+      properties:
+        name:
+          description: The name of the step.
+          example: Example step name
+          type: string
+        subtype:
+          $ref: '#/components/schemas/SyntheticsAPIWaitStepSubtype'
+        value:
+          description: 'The time to wait in seconds. Minimum value: 0. Maximum value:
+            180.'
+          example: 5
+          format: int32
+          maximum: 180
+          minimum: 0
+          type: integer
+      required:
+      - name
+      - subtype
+      - value
+      type: object
+    SyntheticsAPIWaitStepSubtype:
+      description: The subtype of the Synthetic multi-step API wait step.
+      enum:
+      - wait
+      example: wait
+      type: string
+      x-enum-varnames:
+      - WAIT
     SyntheticsApiTestFailureCode:
       description: Error code that can be returned by a Synthetic test.
       enum:
@@ -13675,9 +13725,45 @@ components:
         which property they apply, and upon which target.'
       oneOf:
       - $ref: '#/components/schemas/SyntheticsAssertionTarget'
+      - $ref: '#/components/schemas/SyntheticsAssertionBodyHashTarget'
       - $ref: '#/components/schemas/SyntheticsAssertionJSONPathTarget'
       - $ref: '#/components/schemas/SyntheticsAssertionJSONSchemaTarget'
       - $ref: '#/components/schemas/SyntheticsAssertionXPathTarget'
+    SyntheticsAssertionBodyHashOperator:
+      description: Assertion operator to apply.
+      enum:
+      - md5
+      - sha1
+      - sha256
+      example: md5
+      type: string
+      x-enum-varnames:
+      - MD5
+      - SHA1
+      - SHA256
+    SyntheticsAssertionBodyHashTarget:
+      description: An assertion which targets body hash.
+      properties:
+        operator:
+          $ref: '#/components/schemas/SyntheticsAssertionBodyHashOperator'
+        target:
+          description: Value used by the operator.
+          example: 123456
+        type:
+          $ref: '#/components/schemas/SyntheticsAssertionBodyHashType'
+      required:
+      - type
+      - operator
+      - target
+      type: object
+    SyntheticsAssertionBodyHashType:
+      description: Type of the assertion.
+      enum:
+      - bodyHash
+      example: bodyHash
+      type: string
+      x-enum-varnames:
+      - BODY_HASH
     SyntheticsAssertionJSONPathOperator:
       description: Assertion operator to apply.
       enum:
@@ -13705,6 +13791,12 @@ components:
     SyntheticsAssertionJSONPathTargetTarget:
       description: Composed target for `validatesJSONPath` operator.
       properties:
+        elementsOperator:
+          description: The element from the list of results to assert on.  To choose
+            from the first element in the list `firstElementMatches`, every element
+            in the list `everyElementMatches`, at least one element in the list `atLeastOneElementMatches`
+            or the serialized value of the list `serializationMatches`.
+          type: string
         jsonPath:
           description: The JSON path to assert.
           type: string
@@ -15838,7 +15930,6 @@ components:
 
             (in minutes).'
           format: int64
-          maximum: 1440
           minimum: 0
           type: integer
       type: object
@@ -16057,6 +16148,10 @@ components:
           description: Name of the file.
           maxLength: 1500
           type: string
+        originalFileName:
+          description: Original name of the file.
+          maxLength: 1500
+          type: string
         size:
           description: Size of the file.
           format: int64
@@ -16392,6 +16487,8 @@ components:
           $ref: '#/components/schemas/LogQueryDefinition'
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+        sort:
+          $ref: '#/components/schemas/WidgetSortBy'
       type: object
     TagToHosts:
       description: In this object, the key is the tag, the value is a list of host
@@ -16728,6 +16825,8 @@ components:
           $ref: '#/components/schemas/LogQueryDefinition'
         security_query:
           $ref: '#/components/schemas/LogQueryDefinition'
+        sort:
+          $ref: '#/components/schemas/WidgetSortBy'
         style:
           $ref: '#/components/schemas/WidgetRequestStyle'
       type: object
@@ -18199,7 +18298,7 @@ components:
       x-enum-varnames:
       - REPORTS
     UsageRumSessionsHour:
-      description: Number of RUM Sessions recorded for each hour for a given organization.
+      description: Number of RUM sessions recorded for each hour for a given organization.
       properties:
         hour:
           description: The hour for the usage.
@@ -18212,46 +18311,46 @@ components:
           description: The organization public ID.
           type: string
         replay_session_count:
-          description: Contains the number of RUM Replay Sessions (data available
+          description: Contains the number of RUM Session Replay counts (data available
             beginning November 1, 2021).
           format: int64
           type: integer
         session_count:
-          description: Contains the number of browser RUM Lite Sessions.
+          description: Contains the number of browser RUM lite Sessions.
           format: int64
           nullable: true
           type: integer
         session_count_android:
-          description: Contains the number of mobile RUM Sessions on Android (data
+          description: Contains the number of mobile RUM sessions on Android (data
             available beginning December 1, 2020).
           format: int64
           nullable: true
           type: integer
         session_count_flutter:
-          description: Contains the number of mobile RUM Sessions on Flutter (data
+          description: Contains the number of mobile RUM sessions on Flutter (data
             available beginning March 1, 2023).
           format: int64
           nullable: true
           type: integer
         session_count_ios:
-          description: Contains the number of mobile RUM Sessions on iOS (data available
+          description: Contains the number of mobile RUM sessions on iOS (data available
             beginning December 1, 2020).
           format: int64
           nullable: true
           type: integer
         session_count_reactnative:
-          description: Contains the number of mobile RUM Sessions on React Native
+          description: Contains the number of mobile RUM sessions on React Native
             (data available beginning May 1, 2022).
           format: int64
           nullable: true
           type: integer
       type: object
     UsageRumSessionsResponse:
-      description: Response containing the number of RUM Sessions for each hour for
+      description: Response containing the number of RUM sessions for each hour for
         a given organization.
       properties:
         usage:
-          description: Get hourly usage for RUM Sessions.
+          description: Get hourly usage for RUM sessions.
           items:
             $ref: '#/components/schemas/UsageRumSessionsHour'
           type: array
@@ -18507,7 +18606,8 @@ components:
         audit_logs_lines_indexed_sum:
           deprecated: true
           description: Shows the sum of audit logs lines indexed over all hours in
-            the current date for all organizations.
+            the current date for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         audit_trail_enabled_hwm:
@@ -18545,18 +18645,22 @@ components:
           format: int64
           type: integer
         browser_rum_lite_session_count_sum:
+          deprecated: true
           description: Shows the sum of all browser lite sessions over all hours in
-            the current date for all organizations.
+            the current date for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         browser_rum_replay_session_count_sum:
           description: Shows the sum of all browser replay sessions over all hours
-            in the current date for all organizations.
+            in the current date for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         browser_rum_units_sum:
+          deprecated: true
           description: Shows the sum of all browser RUM units over all hours in the
-            current date for all organizations.
+            current date for all organizations (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
         ci_pipeline_indexed_spans_sum:
@@ -18832,43 +18936,58 @@ components:
           format: int64
           type: integer
         mobile_rum_lite_session_count_sum:
+          deprecated: true
           description: Shows the sum of all mobile lite sessions over all hours in
-            the current date for all organizations.
+            the current date for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         mobile_rum_session_count_android_sum:
-          description: Shows the sum of all mobile RUM Sessions on Android over all
-            hours in the current date for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on Android over all
+            hours in the current date for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_flutter_sum:
-          description: Shows the sum of all mobile RUM Sessions on Flutter over all
-            hours in the current date for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on Flutter over all
+            hours in the current date for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_ios_sum:
-          description: Shows the sum of all mobile RUM Sessions on iOS over all hours
-            in the current date for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on iOS over all hours
+            in the current date for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_reactnative_sum:
-          description: Shows the sum of all mobile RUM Sessions on React Native over
-            all hours in the current date for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on React Native over
+            all hours in the current date for all organizations (To be deprecated
+            on October 1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_roku_sum:
-          description: Shows the sum of all mobile RUM Sessions on Roku over all hours
-            in the current date for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on Roku over all hours
+            in the current date for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_sum:
-          description: Shows the sum of all mobile RUM Sessions over all hours in
-            the current date for all organizations
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions over all hours in
+            the current date for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         mobile_rum_units_sum:
+          deprecated: true
           description: Shows the sum of all mobile RUM units over all hours in the
-            current date for all organizations.
+            current date for all organizations (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
         ndm_netflow_events_sum:
@@ -18877,8 +18996,10 @@ components:
           format: int64
           type: integer
         netflow_indexed_events_count_sum:
+          deprecated: true
           description: Shows the sum of all Network flows indexed over all hours in
-            the current date for all organizations.
+            the current date for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         npm_host_top99p:
@@ -18925,22 +19046,117 @@ components:
           type: integer
         rum_browser_and_mobile_session_count:
           description: Shows the sum of all mobile sessions and all browser lite and
-            legacy sessions over all hours in the current month for all organizations.
+            legacy sessions over all hours in the current month for all organizations
+            (To be deprecated on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_browser_legacy_session_count_sum:
+          description: Shows the sum of all browser RUM legacy sessions over all hours
+            in the current date for all organizations (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_browser_lite_session_count_sum:
+          description: Shows the sum of all browser RUM lite sessions over all hours
+            in the current date for all organizations (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_browser_replay_session_count_sum:
+          description: Shows the sum of all browser RUM Session Replay counts over
+            all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_lite_session_count_sum:
+          description: Shows the sum of all RUM lite sessions (browser and mobile)
+            over all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_android_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on Android
+            over all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_flutter_sum:
+          description: Shows the sum of all mobile RUM legacy Sessions on Flutter
+            over all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_ios_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on iOS over
+            all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_reactnative_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on React Native
+            over all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_roku_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on Roku over
+            all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_android_sum:
+          description: Shows the sum of all mobile RUM lite sessions on Android over
+            all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_flutter_sum:
+          description: Shows the sum of all mobile RUM lite sessions on Flutter over
+            all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_ios_sum:
+          description: Shows the sum of all mobile RUM lite sessions on iOS over all
+            hours in the current date for all organizations (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_reactnative_sum:
+          description: Shows the sum of all mobile RUM lite sessions on React Native
+            over all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_roku_sum:
+          description: Shows the sum of all mobile RUM lite sessions on Roku over
+            all hours in the current date for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_replay_session_count_sum:
+          description: Shows the sum of all RUM Session Replay counts over all hours
+            in the current date for all organizations (To be introduced on October
+            1st, 2024).
           format: int64
           type: integer
         rum_session_count_sum:
-          description: Shows the sum of all browser RUM Lite Sessions over all hours
-            in the current date for all organizations
+          deprecated: true
+          description: Shows the sum of all browser RUM lite sessions over all hours
+            in the current date for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         rum_total_session_count_sum:
-          description: Shows the sum of RUM Sessions (browser and mobile) over all
+          description: Shows the sum of RUM sessions (browser and mobile) over all
             hours in the current date for all organizations.
           format: int64
           type: integer
         rum_units_sum:
+          deprecated: true
           description: Shows the sum of all browser and mobile RUM units over all
-            hours in the current date for all organizations.
+            hours in the current date for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         sds_apm_scanned_bytes_sum:
@@ -19077,7 +19293,8 @@ components:
         audit_logs_lines_indexed_sum:
           deprecated: true
           description: Shows the sum of all audit logs lines indexed over all hours
-            in the current date for the given org.
+            in the current date for the given org (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         audit_trail_enabled_hwm:
@@ -19115,18 +19332,21 @@ components:
           format: int64
           type: integer
         browser_rum_lite_session_count_sum:
+          deprecated: true
           description: Shows the sum of all browser lite sessions over all hours in
-            the current date for the given org.
+            the current date for the given org (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
         browser_rum_replay_session_count_sum:
           description: Shows the sum of all browser replay sessions over all hours
-            in the current date for the given org.
+            in the current date for the given org (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         browser_rum_units_sum:
+          deprecated: true
           description: Shows the sum of all browser RUM units over all hours in the
-            current date for the given org.
+            current date for the given org (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
         ci_pipeline_indexed_spans_sum:
@@ -19386,8 +19606,9 @@ components:
           format: int64
           type: integer
         indexed_events_count_sum:
+          deprecated: true
           description: Shows the sum of all log events indexed over all hours in the
-            current date for the given org.
+            current date for the given org (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
         infra_host_top99p:
@@ -19411,43 +19632,56 @@ components:
           format: int64
           type: integer
         mobile_rum_lite_session_count_sum:
+          deprecated: true
           description: Shows the sum of all mobile lite sessions over all hours in
-            the current date for the given org.
+            the current date for the given org (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_android_sum:
-          description: Shows the sum of all mobile RUM Sessions on Android over all
-            hours in the current date for the given org.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on Android over all
+            hours in the current date for the given org (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_flutter_sum:
-          description: Shows the sum of all mobile RUM Sessions on Flutter over all
-            hours in the current date for the given org.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on Flutter over all
+            hours in the current date for the given org (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_ios_sum:
-          description: Shows the sum of all mobile RUM Sessions on iOS over all hours
-            in the current date for the given org.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on iOS over all hours
+            in the current date for the given org (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         mobile_rum_session_count_reactnative_sum:
-          description: Shows the sum of all mobile RUM Sessions on React Native over
-            all hours in the current date for the given org.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on React Native over
+            all hours in the current date for the given org (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_roku_sum:
-          description: Shows the sum of all mobile RUM Sessions on Roku over all hours
-            in the current date for the given org.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on Roku over all hours
+            in the current date for the given org (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         mobile_rum_session_count_sum:
-          description: Shows the sum of all mobile RUM Sessions over all hours in
-            the current date for the given org.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions over all hours in
+            the current date for the given org (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
         mobile_rum_units_sum:
+          deprecated: true
           description: Shows the sum of all mobile RUM units over all hours in the
-            current date for the given org.
+            current date for the given org (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
         name:
@@ -19459,8 +19693,9 @@ components:
           format: int64
           type: integer
         netflow_indexed_events_count_sum:
+          deprecated: true
           description: Shows the sum of all Network flows indexed over all hours in
-            the current date for the given org.
+            the current date for the given org (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
         npm_host_top99p:
@@ -19508,22 +19743,117 @@ components:
           type: string
         rum_browser_and_mobile_session_count:
           description: Shows the sum of all mobile sessions and all browser lite and
-            legacy sessions over all hours in the current date for the given org.
+            legacy sessions over all hours in the current date for the given org (To
+            be deprecated on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_browser_legacy_session_count_sum:
+          description: Shows the sum of all browser RUM legacy sessions over all hours
+            in the current date for the given org (To be introduced on October 1st,
+            2024).
+          format: int64
+          type: integer
+        rum_browser_lite_session_count_sum:
+          description: Shows the sum of all browser RUM lite sessions over all hours
+            in the current date for the given org (To be introduced on October 1st,
+            2024).
+          format: int64
+          type: integer
+        rum_browser_replay_session_count_sum:
+          description: Shows the sum of all browser RUM Session Replay counts over
+            all hours in the current date for the given org (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_lite_session_count_sum:
+          description: Shows the sum of all RUM lite sessions (browser and mobile)
+            over all hours in the current date for the given org (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_android_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on Android
+            over all hours in the current date for the given org (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_flutter_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on Flutter
+            over all hours in the current date for the given org (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_ios_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on iOS over
+            all hours in the current date for the given org (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_reactnative_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on React Native
+            over all hours in the current date for the given org (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_roku_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on Roku over
+            all hours in the current date for the given org (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_android_sum:
+          description: Shows the sum of all mobile RUM lite sessions on Android over
+            all hours in the current date for the given org (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_flutter_sum:
+          description: Shows the sum of all mobile RUM lite sessions on Flutter over
+            all hours in the current date for the given org (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_ios_sum:
+          description: Shows the sum of all mobile RUM lite sessions on iOS over all
+            hours in the current date for the given org (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_reactnative_sum:
+          description: Shows the sum of all mobile RUM lite sessions on React Native
+            over all hours in the current date for the given org (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_roku_sum:
+          description: Shows the sum of all mobile RUM lite sessions on Roku over
+            all hours in the current date for the given org (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_replay_session_count_sum:
+          description: Shows the sum of all RUM Session Replay counts over all hours
+            in the current date for the given org (To be introduced on October 1st,
+            2024).
           format: int64
           type: integer
         rum_session_count_sum:
-          description: Shows the sum of all browser RUM Lite Sessions over all hours
-            in the current date for the given org.
+          deprecated: true
+          description: Shows the sum of all browser RUM lite sessions over all hours
+            in the current date for the given org (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         rum_total_session_count_sum:
-          description: Shows the sum of RUM Sessions (browser and mobile) over all
+          description: Shows the sum of RUM sessions (browser and mobile) over all
             hours in the current date for the given org.
           format: int64
           type: integer
         rum_units_sum:
+          deprecated: true
           description: Shows the sum of all browser and mobile RUM units over all
-            hours in the current date for the given org.
+            hours in the current date for the given org (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         sds_apm_scanned_bytes_sum:
@@ -19660,7 +19990,8 @@ components:
         audit_logs_lines_indexed_agg_sum:
           deprecated: true
           description: Shows the sum of all audit logs lines indexed over all hours
-            in the current month for all organizations.
+            in the current month for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         audit_trail_enabled_hwm_sum:
@@ -19704,18 +20035,23 @@ components:
           format: int64
           type: integer
         browser_rum_lite_session_count_agg_sum:
+          deprecated: true
           description: Shows the sum of all browser lite sessions over all hours in
-            the current month for all organizations.
+            the current month for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         browser_rum_replay_session_count_agg_sum:
           description: Shows the sum of all browser replay sessions over all hours
-            in the current month for all organizations.
+            in the current month for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         browser_rum_units_agg_sum:
+          deprecated: true
           description: Shows the sum of all browser RUM units over all hours in the
-            current month for all organizations.
+            current month for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         ci_pipeline_indexed_spans_agg_sum:
@@ -19975,8 +20311,10 @@ components:
           format: int64
           type: integer
         indexed_events_count_agg_sum:
+          deprecated: true
           description: Shows the sum of all log events indexed over all hours in the
-            current month for all organizations.
+            current month for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         infra_host_top99p_sum:
@@ -20005,9 +20343,9 @@ components:
           format: date-time
           type: string
         live_indexed_events_agg_sum:
+          deprecated: true
           description: Shows the sum of all live logs indexed over all hours in the
-            current month for all organizations (data available as of December 1,
-            2020).
+            current month for all organization (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
         live_ingested_bytes_agg_sum:
@@ -20019,43 +20357,59 @@ components:
         logs_by_retention:
           $ref: '#/components/schemas/LogsByRetention'
         mobile_rum_lite_session_count_agg_sum:
+          deprecated: true
           description: Shows the sum of all mobile lite sessions over all hours in
-            the current month for all organizations.
+            the current month for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         mobile_rum_session_count_agg_sum:
-          description: Shows the sum of all mobile RUM Sessions over all hours in
-            the current month for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions over all hours in
+            the current month for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         mobile_rum_session_count_android_agg_sum:
-          description: Shows the sum of all mobile RUM Sessions on Android over all
-            hours in the current month for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on Android over all
+            hours in the current month for all organizations (To be deprecated on
+            October 1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_flutter_agg_sum:
-          description: Shows the sum of all mobile RUM Sessions on Flutter over all
-            hours in the current month for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on Flutter over all
+            hours in the current month for all organizations (To be deprecated on
+            October 1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_ios_agg_sum:
-          description: Shows the sum of all mobile RUM Sessions on iOS over all hours
-            in the current month for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on iOS over all hours
+            in the current month for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_reactnative_agg_sum:
-          description: Shows the sum of all mobile RUM Sessions on React Native over
-            all hours in the current month for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on React Native over
+            all hours in the current month for all organizations (To be deprecated
+            on October 1st, 2024).
           format: int64
           type: integer
         mobile_rum_session_count_roku_agg_sum:
-          description: Shows the sum of all mobile RUM Sessions on Roku over all hours
-            in the current month for all organizations.
+          deprecated: true
+          description: Shows the sum of all mobile RUM sessions on Roku over all hours
+            in the current month for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         mobile_rum_units_agg_sum:
+          deprecated: true
           description: Shows the sum of all mobile RUM units over all hours in the
-            current month for all organizations.
+            current month for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         ndm_netflow_events_agg_sum:
@@ -20064,8 +20418,10 @@ components:
           format: int64
           type: integer
         netflow_indexed_events_count_agg_sum:
+          deprecated: true
           description: Shows the sum of all Network flows indexed over all hours in
-            the current month for all organizations.
+            the current month for all organizations (To be deprecated on October 1st,
+            2024).
           format: int64
           type: integer
         npm_host_top99p_sum:
@@ -20111,9 +20467,10 @@ components:
           format: int64
           type: integer
         rehydrated_indexed_events_agg_sum:
+          deprecated: true
           description: Shows the sum of all rehydrated logs indexed over all hours
-            in the current month for all organizations (data available as of December
-            1, 2020).
+            in the current month for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         rehydrated_ingested_bytes_agg_sum:
@@ -20124,22 +20481,117 @@ components:
           type: integer
         rum_browser_and_mobile_session_count:
           description: Shows the sum of all mobile sessions and all browser lite and
-            legacy sessions over all hours in the current month for all organizations.
+            legacy sessions over all hours in the current month for all organizations
+            (To be deprecated on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_browser_legacy_session_count_agg_sum:
+          description: Shows the sum of all browser RUM legacy sessions over all hours
+            in the current month for all organizations (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_browser_lite_session_count_agg_sum:
+          description: Shows the sum of all browser RUM lite sessions over all hours
+            in the current month for all organizations (To be introduced on October
+            1st, 2024).
+          format: int64
+          type: integer
+        rum_browser_replay_session_count_agg_sum:
+          description: Shows the sum of all browser RUM Session Replay counts over
+            all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_lite_session_count_agg_sum:
+          description: Shows the sum of all RUM lite sessions (browser and mobile)
+            over all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_android_agg_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on Android
+            over all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_flutter_agg_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on Flutter
+            over all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_ios_agg_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on iOS over
+            all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_reactnative_agg_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on React Native
+            over all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_legacy_session_count_roku_agg_sum:
+          description: Shows the sum of all mobile RUM legacy sessions on Roku over
+            all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_android_agg_sum:
+          description: Shows the sum of all mobile RUM lite sessions on Android over
+            all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_flutter_agg_sum:
+          description: Shows the sum of all mobile RUM lite sessions on Flutter over
+            all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_ios_agg_sum:
+          description: Shows the sum of all mobile RUM lite sessions on iOS over all
+            hours in the current month for all organizations (To be introduced on
+            October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_reactnative_agg_sum:
+          description: Shows the sum of all mobile RUM lite sessions on React Native
+            over all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_mobile_lite_session_count_roku_agg_sum:
+          description: Shows the sum of all mobile RUM lite sessions on Roku over
+            all hours in the current month for all organizations (To be introduced
+            on October 1st, 2024).
+          format: int64
+          type: integer
+        rum_replay_session_count_agg_sum:
+          description: Shows the sum of all RUM Session Replay counts over all hours
+            in the current month for all organizations (To be introduced on October
+            1st, 2024).
           format: int64
           type: integer
         rum_session_count_agg_sum:
-          description: Shows the sum of all browser RUM Lite Sessions over all hours
-            in the current month for all organizations.
+          deprecated: true
+          description: Shows the sum of all browser RUM lite sessions over all hours
+            in the current month for all organizations (To be deprecated on October
+            1st, 2024).
           format: int64
           type: integer
         rum_total_session_count_agg_sum:
-          description: Shows the sum of RUM Sessions (browser and mobile) over all
+          description: Shows the sum of RUM sessions (browser and mobile) over all
             hours in the current month for all organizations.
           format: int64
           type: integer
         rum_units_agg_sum:
+          deprecated: true
           description: Shows the sum of all browser and mobile RUM units over all
-            hours in the current month for all organizations.
+            hours in the current month for all organizations (To be deprecated on
+            October 1st, 2024).
           format: int64
           type: integer
         sds_apm_scanned_bytes_sum:
@@ -20939,6 +21391,24 @@ components:
         order:
           $ref: '#/components/schemas/QuerySortOrder'
       type: object
+    WidgetFormulaSort:
+      description: The formula to sort the widget by.
+      properties:
+        index:
+          description: The index of the formula to sort by.
+          example: 0
+          format: int64
+          minimum: 0
+          type: integer
+        order:
+          $ref: '#/components/schemas/WidgetSort'
+        type:
+          $ref: '#/components/schemas/FormulaType'
+      required:
+      - type
+      - index
+      - order
+      type: object
     WidgetFormulaStyle:
       description: Styling options for widget formulas.
       properties:
@@ -20953,6 +21423,22 @@ components:
           format: int64
           type: integer
       type: object
+    WidgetGroupSort:
+      description: The group to sort the widget by.
+      properties:
+        name:
+          description: The name of the group.
+          example: group_name
+          type: string
+        order:
+          $ref: '#/components/schemas/WidgetSort'
+        type:
+          $ref: '#/components/schemas/GroupType'
+      required:
+      - type
+      - name
+      - order
+      type: object
     WidgetGrouping:
       description: The kind of grouping to use.
       enum:
@@ -21328,6 +21814,25 @@ components:
       x-enum-varnames:
       - ASCENDING
       - DESCENDING
+    WidgetSortBy:
+      description: The controls for sorting the widget.
+      properties:
+        count:
+          description: The number of items to limit the widget to.
+          format: int64
+          minimum: 0
+          type: integer
+        order_by:
+          description: The array of items to sort the widget by in order.
+          items:
+            $ref: '#/components/schemas/WidgetSortOrderBy'
+          type: array
+      type: object
+    WidgetSortOrderBy:
+      description: The item to sort the widget by.
+      oneOf:
+      - $ref: '#/components/schemas/WidgetFormulaSort'
+      - $ref: '#/components/schemas/WidgetGroupSort'
     WidgetStyle:
       description: Widget style definition.
       properties:
@@ -21436,10 +21941,14 @@ components:
         authorizationCode:
           authorizationUrl: /oauth2/v1/authorize
           scopes:
+            apm_api_catalog_read: View API catalog and API definitions.
+            apm_api_catalog_write: Add, modify, and delete API catalog definitions.
             apm_read: Read and query APM and Trace Analytics.
             apm_service_catalog_read: View service catalog and service definitions.
             apm_service_catalog_write: Add, modify, and delete service catalog definitions
               when those definitions are maintained by Datadog.
+            cases_read: View Cases.
+            cases_write: Create and update cases.
             ci_visibility_pipelines_write: Create CI Visibility pipeline spans using
               the API.
             ci_visibility_read: View CI Visibility.
@@ -21508,6 +22017,9 @@ components:
             user_access_manage: Disable users, manage user roles, manage SAML-to-role
               mappings, and configure logs restriction queries.
             user_access_read: View users and their roles and settings.
+            workflows_read: View workflows.
+            workflows_run: Run workflows.
+            workflows_write: Create, edit, and delete workflows.
           tokenUrl: /oauth2/v1/token
       type: oauth2
     apiKeyAuth:
@@ -26892,22 +27404,20 @@ paths:
       description: Search and filter your monitor groups details.
       operationId: SearchMonitorGroups
       parameters:
-      - description: 'After entering a search query in your [Manage Monitor page][1]
+      - description: 'After entering a search query on the [Triggered Monitors page][1],
           use the query parameter value in the
 
-          URL of the page as value for this parameter. Consult the dedicated [manage
-          monitor documentation][2]
-
-          page to learn more.
+          URL of the page as a value for this parameter. For more information, see
+          the [Manage Monitors documentation][2].
 
 
           The query can contain any number of space-separated monitor attributes,
-          for instance `query="type:metric status:alert"`.
+          for instance: `query="type:metric group_status:alert"`.
 
 
-          [1]: https://app.datadoghq.com/monitors/manage
+          [1]: https://app.datadoghq.com/monitors/triggered
 
-          [2]: /monitors/manage/#find-the-monitors'
+          [2]: /monitors/manage/#triggered-monitors'
         in: query
         name: query
         required: false