datadog_api_client 2.10.0 → 2.11.0

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

@@ -1744,6 +1744,10 @@ components:
             be muted.
           example: false
           type: boolean
+        notify_end_states:
+          $ref: '#/components/schemas/NotifyEndStates'
+        notify_end_types:
+          $ref: '#/components/schemas/NotifyEndTypes'
         parent_id:
           description: ID of the parent Downtime.
           example: 123
@@ -1880,6 +1884,10 @@ components:
             be muted.
           example: false
           type: boolean
+        notify_end_states:
+          $ref: '#/components/schemas/NotifyEndStates'
+        notify_end_types:
+          $ref: '#/components/schemas/NotifyEndTypes'
         parent_id:
           description: ID of the parent Downtime.
           example: 123
@@ -2720,6 +2728,7 @@ components:
       - $ref: '#/components/schemas/FormulaAndFunctionProcessQueryDefinition'
       - $ref: '#/components/schemas/FormulaAndFunctionApmDependencyStatsQueryDefinition'
       - $ref: '#/components/schemas/FormulaAndFunctionApmResourceStatsQueryDefinition'
+      - $ref: '#/components/schemas/FormulaAndFunctionSLOQueryDefinition'
       type: object
     FormulaAndFunctionResponseFormat:
       description: Timeseries or Scalar response.
@@ -2731,6 +2740,81 @@ components:
       x-enum-varnames:
       - TIMESERIES
       - SCALAR
+    FormulaAndFunctionSLODataSource:
+      description: Data source for SLO measures queries.
+      enum:
+      - slo
+      example: slo
+      type: string
+      x-enum-varnames:
+      - SLO
+    FormulaAndFunctionSLOGroupMode:
+      description: Group mode to query measures.
+      enum:
+      - overall
+      - components
+      example: overall
+      type: string
+      x-enum-varnames:
+      - OVERALL
+      - COMPONENTS
+    FormulaAndFunctionSLOMeasure:
+      description: SLO measures queries.
+      enum:
+      - good_events
+      - bad_events
+      - slo_status
+      - error_budget_remaining
+      - burn_rate
+      - error_budget_burndown
+      example: slo_status
+      type: string
+      x-enum-varnames:
+      - GOOD_EVENTS
+      - BAD_EVENTS
+      - SLO_STATUS
+      - ERROR_BUDGET_REMAINING
+      - BURN_RATE
+      - ERROR_BUDGET_BURNDOWN
+    FormulaAndFunctionSLOQueryDefinition:
+      description: A formula and functions metrics query.
+      example:
+        data_source: slo
+        group_mode: overall
+        measure: good_events
+        name: my_slo
+        slo_id: '12345678910'
+        slo_query_type: metric
+      properties:
+        data_source:
+          $ref: '#/components/schemas/FormulaAndFunctionSLODataSource'
+        group_mode:
+          $ref: '#/components/schemas/FormulaAndFunctionSLOGroupMode'
+        measure:
+          $ref: '#/components/schemas/FormulaAndFunctionSLOMeasure'
+        name:
+          description: Name of the query for use in formulas.
+          example: my_slo
+          type: string
+        slo_id:
+          description: ID of an SLO to query measures.
+          example: '12345678910'
+          type: string
+        slo_query_type:
+          $ref: '#/components/schemas/FormulaAndFunctionSLOQueryType'
+      required:
+      - data_source
+      - slo_id
+      - measure
+      type: object
+    FormulaAndFunctionSLOQueryType:
+      description: Name of the query for use in formulas.
+      enum:
+      - metric
+      example: metric
+      type: string
+      x-enum-varnames:
+      - METRIC
     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
@@ -3750,12 +3834,14 @@ components:
       - infra_host_usage
       - invocations_usage
       - npm_host_usage
+      - obs_pipeline_bytes_usage
       - profiled_container_usage
       - profiled_fargate_usage
       - profiled_host_usage
       - snmp_usage
       - estimated_rum_sessions_usage
       - universal_service_monitoring_usage
+      - vuln_management_hosts_usage
       type: string
       x-enum-varnames:
       - API_USAGE
@@ -3783,12 +3869,14 @@ components:
       - INFRA_HOST_USAGE
       - INVOCATIONS_USAGE
       - NPM_HOST_USAGE
+      - OBS_PIPELINE_BYTES_USAGE
       - PROFILED_CONTAINER_USAGE
       - PROFILED_FARGATE_USAGE
       - PROFILED_HOST_USAGE
       - SNMP_USAGE
       - ESTIMATED_RUM_SESSIONS_USAGE
       - UNIVERSAL_SERVICE_MONITORING_USAGE
+      - VULN_MANAGEMENT_HOSTS_USAGE
     IFrameWidgetDefinition:
       description: The iframe widget allows you to embed a portion of any other web
         page on your dashboard. Only available on FREE layout dashboards.
@@ -4201,6 +4289,8 @@ components:
           description: Widget query.
           example: '@service:app'
           type: string
+        sort:
+          $ref: '#/components/schemas/WidgetFieldSort'
         storage:
           description: Option for storage location. Feature in Private Beta.
           example: indexes
@@ -5743,6 +5833,43 @@ components:
       type: string
       x-enum-varnames:
       - USER_AGENT_PARSER
+    MatchingDowntime:
+      description: Object describing a downtime that matches this monitor.
+      properties:
+        end:
+          description: POSIX timestamp to end the downtime.
+          example: 1412792983
+          format: int64
+          nullable: true
+          type: integer
+        id:
+          description: The downtime ID.
+          example: 1625
+          format: int64
+          readOnly: true
+          type: integer
+        scope:
+          description: 'The scope(s) to which the downtime applies. Must be in `key:value`
+            format. For example, `host:app2`.
+
+            Provide multiple scopes as a comma-separated list like `env:dev,env:prod`.
+
+            The resulting downtime applies to sources that matches ALL provided scopes
+            (`env:dev` **AND** `env:prod`).'
+          example:
+          - env:staging
+          items:
+            description: A scope. For example, `"env:staging"`.
+            type: string
+          type: array
+        start:
+          description: POSIX timestamp to start the downtime.
+          example: 1412792983
+          format: int64
+          type: integer
+      required:
+      - id
+      type: object
     MetricContentEncoding:
       default: deflate
       description: HTTP header used to compress the media-type.
@@ -6023,6 +6150,11 @@ components:
           format: int64
           readOnly: true
           type: integer
+        matching_downtimes:
+          description: A list of active downtimes that match this monitor.
+          items:
+            $ref: '#/components/schemas/MatchingDowntime'
+          type: array
         message:
           description: A message to include with notifications for this monitor.
           type: string
@@ -7240,6 +7372,8 @@ components:
       - invocations_percentage
       - npm_host_usage
       - npm_host_percentage
+      - obs_pipeline_bytes_usage
+      - obs_pipeline_bytes_percentage
       - profiled_container_usage
       - profiled_container_percentage
       - profiled_fargate_usage
@@ -7252,6 +7386,8 @@ components:
       - estimated_rum_sessions_percentage
       - universal_service_monitoring_usage
       - universal_service_monitoring_percentage
+      - vuln_management_hosts_usage
+      - vuln_management_hosts_percentage
       - '*'
       type: string
       x-enum-varnames:
@@ -7305,6 +7441,8 @@ components:
       - INVOCATIONS_PERCENTAGE
       - NPM_HOST_USAGE
       - NPM_HOST_PERCENTAGE
+      - OBS_PIPELINE_BYTES_USAGE
+      - OBS_PIPELINE_BYTES_PERCENTAGE
       - PROFILED_CONTAINER_USAGE
       - PROFILED_CONTAINER_PERCENTAGE
       - PROFILED_FARGATE_USAGE
@@ -7317,6 +7455,8 @@ components:
       - ESTIMATED_RUM_SESSIONS_PERCENTAGE
       - UNIVERSAL_SERVICE_MONITORING_USAGE
       - UNIVERSAL_SERVICE_MONITORING_PERCENTAGE
+      - VULN_MANAGEMENT_HOSTS_USAGE
+      - VULN_MANAGEMENT_HOSTS_PERCENTAGE
       - ALL
     MonthlyUsageAttributionValues:
       description: Fields in Usage Summary by tag(s).
@@ -7534,6 +7674,14 @@ components:
           description: The network host usage by tag(s).
           format: double
           type: number
+        obs_pipeline_bytes_percentage:
+          description: The percentage of observability pipeline bytes usage by tag(s).
+          format: double
+          type: number
+        obs_pipeline_bytes_usage:
+          description: The observability pipeline bytes usage by tag(s).
+          format: double
+          type: number
         profiled_container_percentage:
           description: The percentage of profiled container usage by tag(s).
           format: double
@@ -7574,6 +7722,15 @@ components:
           description: The universal service monitoring usage by tag(s).
           format: double
           type: number
+        vuln_management_hosts_percentage:
+          description: The percentage of Application Vulnerability Management usage
+            by tag(s).
+          format: double
+          type: number
+        vuln_management_hosts_usage:
+          description: The Application Vulnerability Management usage by tag(s).
+          format: double
+          type: number
       type: object
     NoteWidgetDefinition:
       description: The notes and links widget is similar to free text widget, but
@@ -8399,6 +8556,60 @@ components:
           format: int64
           type: integer
       type: object
+    NotifyEndState:
+      description: A notification end state.
+      enum:
+      - alert
+      - no data
+      - warn
+      example: alert
+      type: string
+      x-enum-varnames:
+      - ALERT
+      - NO_DATA
+      - WARN
+    NotifyEndStates:
+      default:
+      - alert
+      - no data
+      - warn
+      description: States for which `notify_end_types` sends out notifications for.
+      example:
+      - alert
+      - no data
+      - warn
+      items:
+        $ref: '#/components/schemas/NotifyEndState'
+      type: array
+    NotifyEndType:
+      description: A notification end type.
+      enum:
+      - canceled
+      - expired
+      example: expired
+      type: string
+      x-enum-varnames:
+      - CANCELED
+      - EXPIRED
+    NotifyEndTypes:
+      default:
+      - expired
+      description: 'If set, notifies if a monitor is in an alert-worthy state (`ALERT`,
+        `WARNING`, or `NO DATA`)
+
+        when this downtime expires or is canceled. Applied to monitors that change
+        states during
+
+        the downtime (such as from `OK` to `ALERT`, `WARNING`, or `NO DATA`), and
+        to monitors that
+
+        already have an alert-worthy state when downtime begins.'
+      example:
+      - canceled
+      - expired
+      items:
+        $ref: '#/components/schemas/NotifyEndType'
+      type: array
     OnMissingDataOption:
       description: 'Controls how groups or monitors are treated if an evaluation does
         not return any data points.
@@ -10222,6 +10433,9 @@ components:
       description: Use the SLO and uptime widget to track your SLOs (Service Level
         Objectives) and uptime on screenboards and timeboards.
       properties:
+        additional_query_filters:
+          description: Additional filters applied to the SLO query.
+          type: string
         global_time_target:
           description: Defined global time target.
           type: string
@@ -11581,12 +11795,14 @@ components:
       - none
       - false_positive
       - testing_or_maintenance
+      - investigated_case_opened
       - other
       type: string
       x-enum-varnames:
       - NONE
       - FALSE_POSITIVE
       - TESTING_OR_MAINTENANCE
+      - INVESTIGATED_CASE_OPENED
       - OTHER
     SignalAssigneeUpdateRequest:
       description: Attributes describing an assignee update operation over a security
@@ -11815,7 +12031,7 @@ components:
           $ref: '#/components/schemas/LogQueryDefinition'
       type: object
     SyntheticsAPIStep:
-      description: The steps used in a Synthetics multistep API test.
+      description: The steps used in a Synthetic multistep API test.
       properties:
         allowFailure:
           description: Determines whether or not to continue with test if this step
@@ -12243,6 +12459,8 @@ components:
       - networkHop
       - receivedMessage
       - grpcHealthcheckStatus
+      - grpcMetadata
+      - grpcProto
       - connection
       example: statusCode
       type: string
@@ -12263,6 +12481,8 @@ components:
       - NETWORK_HOP
       - RECEIVED_MESSAGE
       - GRPC_HEALTHCHECK_STATUS
+      - GRPC_METADATA
+      - GRPC_PROTO
       - CONNECTION
     SyntheticsAssertionXPathOperator:
       description: Assertion operator to apply.
@@ -12577,7 +12797,7 @@ components:
           $ref: '#/components/schemas/SyntheticsStatus'
       type: object
     SyntheticsBatchResult:
-      description: Object with the results of a Synthetics batch.
+      description: Object with the results of a Synthetic batch.
       properties:
         device:
           $ref: '#/components/schemas/SyntheticsDeviceID'
@@ -12982,7 +13202,7 @@ components:
     SyntheticsBrowserVariable:
       description: 'Object defining a variable that can be used in your browser test.
 
-        Learn more in the [Browser test Actions documentation](https://docs.datadoghq.com/synthetics/browser_tests/actions#variable).'
+        See the [Recording Steps documentation](https://docs.datadoghq.com/synthetics/browser_tests/actions/?tab=testanelementontheactivepage#variables).'
       properties:
         example:
           description: Example for the variable.
@@ -12997,6 +13217,10 @@ components:
         pattern:
           description: Pattern of the variable.
           type: string
+        secure:
+          description: Determines whether or not the browser test variable is obfuscated.
+            Can only be used with browser variables of type `text`.
+          type: boolean
         type:
           $ref: '#/components/schemas/SyntheticsBrowserVariableType'
       required:
@@ -13020,7 +13244,7 @@ components:
       - JAVASCRIPT
       - TEXT
     SyntheticsCIBatchMetadata:
-      description: Metadata for the Synthetics tests run.
+      description: Metadata for the Synthetic tests run.
       properties:
         ci:
           $ref: '#/components/schemas/SyntheticsCIBatchMetadataCI'
@@ -13060,7 +13284,7 @@ components:
           type: string
       type: object
     SyntheticsCITest:
-      description: Test configuration for Synthetics CI
+      description: Configuration for Continuous Testing.
       properties:
         allowInsecureCertificates:
           description: Disable certificate checks in API tests.
@@ -13071,7 +13295,7 @@ components:
           description: Body to include in the test.
           type: string
         bodyType:
-          description: Type of the data sent in a synthetics API test.
+          description: Type of the data sent in a Synthetic API test.
           type: string
         cookies:
           description: Cookies for the request.
@@ -13098,7 +13322,7 @@ components:
         metadata:
           $ref: '#/components/schemas/SyntheticsCIBatchMetadata'
         public_id:
-          description: The public ID of the Synthetics test to trigger.
+          description: The public ID of the Synthetic test to trigger.
           example: aaa-aaa-aaa
           type: string
         retry:
@@ -13332,7 +13556,7 @@ components:
           type: array
       type: object
     SyntheticsGlobalVariable:
-      description: Synthetics global variable.
+      description: Synthetic global variable.
       properties:
         attributes:
           $ref: '#/components/schemas/SyntheticsGlobalVariableAttributes'
@@ -13345,7 +13569,7 @@ components:
           readOnly: true
           type: string
         name:
-          description: Name of the global variable. Unique across Synthetics global
+          description: Name of the global variable. Unique across Synthetic global
             variables.
           example: MY_VARIABLE
           type: string
@@ -13386,8 +13610,8 @@ components:
           $ref: '#/components/schemas/SyntheticsGlobalVariableTOTPParameters'
       type: object
     SyntheticsGlobalVariableParseTestOptions:
-      description: Parser options to use for retrieving a Synthetics global variable
-        from a Synthetics Test. Used in conjunction with `parse_test_public_id`.
+      description: Parser options to use for retrieving a Synthetic global variable
+        from a Synthetic test. Used in conjunction with `parse_test_public_id`.
       properties:
         field:
           description: When type is `http_header`, name of the header to use to extract
@@ -13407,7 +13631,7 @@ components:
       - type
       type: object
     SyntheticsGlobalVariableParseTestOptionsType:
-      description: Property of the Synthetics Test Response to use for a Synthetics
+      description: Property of the Synthetic Test Response to use for a Synthetic
         global variable.
       enum:
       - http_body
@@ -13420,7 +13644,7 @@ components:
       - HTTP_HEADER
       - LOCAL_VARIABLE
     SyntheticsGlobalVariableParserType:
-      description: Type of parser for a Synthetics global variable from a synthetics
+      description: Type of parser for a Synthetic global variable from a synthetics
         test.
       enum:
       - raw
@@ -13502,10 +13726,10 @@ components:
           type: string
       type: object
     SyntheticsLocations:
-      description: List of Synthetics locations.
+      description: List of Synthetic locations.
       properties:
         locations:
-          description: List of Synthetics locations.
+          description: List of Synthetic locations.
           items:
             $ref: '#/components/schemas/SyntheticsLocation'
           type: array
@@ -13524,6 +13748,9 @@ components:
           type: string
         parser:
           $ref: '#/components/schemas/SyntheticsVariableParser'
+        secure:
+          description: Determines whether or not the extracted value will be obfuscated.
+          type: boolean
         type:
           $ref: '#/components/schemas/SyntheticsGlobalVariableParseTestOptionsType'
       type: object
@@ -13749,7 +13976,7 @@ components:
       - skipped
       - failed
     SyntheticsStep:
-      description: The steps used in a Synthetics browser test.
+      description: The steps used in a Synthetic browser test.
       properties:
         allowFailure:
           description: A boolean set to allow this step to fail.
@@ -13810,7 +14037,7 @@ components:
           format: int64
           type: integer
         subTestStepDetails:
-          description: 'If this steps include a sub-test.
+          description: 'If this step includes a sub-test.
 
             [Subtests documentation](https://docs.datadoghq.com/synthetics/browser_tests/advanced_options/#subtests).'
           items:
@@ -14033,7 +14260,7 @@ components:
       - API
       - BROWSER
     SyntheticsTestExecutionRule:
-      description: Execution rule for a Synthetics test.
+      description: Execution rule for a Synthetic test.
       enum:
       - blocking
       - non_blocking
@@ -14422,7 +14649,7 @@ components:
       description: 'Object containing all metrics and their values collected for a
         Synthetic API test.
 
-        Learn more about those metrics in [Synthetics documentation](https://docs.datadoghq.com/synthetics/#metrics).'
+        See the [Synthetic Monitoring Metrics documentation](https://docs.datadoghq.com/synthetics/metrics/).'
       properties:
         dns:
           description: The duration in millisecond of the DNS lookup.
@@ -14462,10 +14689,10 @@ components:
           type: number
       type: object
     SyntheticsTriggerBody:
-      description: Object describing the synthetics tests to trigger.
+      description: Object describing the Synthetic tests to trigger.
       properties:
         tests:
-          description: Individual synthetics test.
+          description: Individual Synthetic test.
           items:
             $ref: '#/components/schemas/SyntheticsTriggerTest'
           type: array
@@ -14473,7 +14700,7 @@ components:
       - tests
       type: object
     SyntheticsTriggerCITestLocation:
-      description: Synthetics location.
+      description: Synthetic location.
       properties:
         id:
           description: Unique identifier of the location.
@@ -14493,7 +14720,7 @@ components:
           format: int64
           type: integer
         public_id:
-          description: The public ID of the Synthetics test.
+          description: The public ID of the Synthetic test.
           type: string
         result_id:
           description: ID of the result.
@@ -14507,7 +14734,7 @@ components:
           nullable: true
           type: string
         locations:
-          description: List of Synthetics locations.
+          description: List of Synthetic locations.
           items:
             $ref: '#/components/schemas/SyntheticsTriggerCITestLocation'
           type: array
@@ -14517,9 +14744,9 @@ components:
             $ref: '#/components/schemas/SyntheticsTriggerCITestRunResult'
           type: array
         triggered_check_ids:
-          description: The public IDs of the Synthetics test triggered.
+          description: The public IDs of the Synthetic test triggered.
           items:
-            description: The public ID of the Synthetics test.
+            description: The public ID of the Synthetic test.
             type: string
           type: array
       type: object
@@ -14529,7 +14756,7 @@ components:
         metadata:
           $ref: '#/components/schemas/SyntheticsCIBatchMetadata'
         public_id:
-          description: The public ID of the Synthetics test to trigger.
+          description: The public ID of the Synthetic test to trigger.
           example: aaa-aaa-aaa
           type: string
       required:
@@ -15185,6 +15412,7 @@ components:
         analyzed_logs:
           description: Contains the number of analyzed logs.
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -16471,6 +16699,7 @@ components:
         indexed_events_count:
           description: Contains the number of spans indexed.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16500,6 +16729,7 @@ components:
           description: Contains the total number of bytes ingested for APM spans during
             a given hour.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16632,11 +16862,13 @@ components:
           description: Total logs indexed with this retention period during a given
             hour.
           format: int64
+          nullable: true
           type: integer
         live_indexed_events_count:
           description: Live logs indexed with this retention period during a given
             hour.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16648,6 +16880,7 @@ components:
           description: Rehydrated logs indexed with this retention period during a
             given hour.
           format: int64
+          nullable: true
           type: integer
         retention:
           description: The retention period in days or "custom" for all custom retention
@@ -16751,6 +16984,7 @@ components:
         indexed_events_count:
           description: Contains the number of netflow events indexed.
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -16972,12 +17206,14 @@ components:
             usage types by the Sensitive Data Scanner from the start of the given
             hour\u2019s month until the given hour."
           format: int64
+          nullable: true
           type: integer
         events_scanned_bytes:
           description: "The total number of bytes scanned of Events usage across all
             usage types by the Sensitive Data Scanner from the start of the given
             hour\u2019s month until the given hour."
           format: int64
+          nullable: true
           type: integer
         hour:
           description: The hour for the usage.
@@ -16988,6 +17224,7 @@ components:
             Data Scanner from the start of the given hour\u2019s month until the given
             hour."
           format: int64
+          nullable: true
           type: integer
         org_name:
           description: The organization name.
@@ -17000,12 +17237,14 @@ components:
             usage types by the Sensitive Data Scanner from the start of the given
             hour\u2019s month until the given hour."
           format: int64
+          nullable: true
           type: integer
         total_scanned_bytes:
           description: "The total number of bytes scanned across all usage types by
             the Sensitive Data Scanner from the start of the given hour\u2019s month
             until the given hour."
           format: int64
+          nullable: true
           type: integer
       type: object
     UsageSDSResponse:
@@ -17532,6 +17771,11 @@ components:
             in the current date for all organizations.
           format: int64
           type: integer
+        vuln_management_host_count_top99p:
+          description: Shows the 99th percentile of all Application Vulnerability
+            Management hosts over all hours in the current date for the given org.
+          format: int64
+          type: integer
       type: object
     UsageSummaryDateOrg:
       description: Global hourly report of all data billed by Datadog for a given
@@ -17937,6 +18181,11 @@ components:
             in the current date for the given org.
           format: int64
           type: integer
+        vuln_management_host_count_top99p:
+          description: Shows the 99th percentile of all Application Vulnerability
+            Management hosts over all hours in the current date for the given org.
+          format: int64
+          type: integer
       type: object
     UsageSummaryResponse:
       description: Response summarizing all usage aggregated across the months in
@@ -18389,6 +18638,11 @@ components:
             in the current months for all organizations.
           format: int64
           type: integer
+        vuln_management_host_count_top99p_sum:
+          description: Shows the 99th percentile of all Application Vulnerability
+            Management 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.
@@ -24446,7 +24700,7 @@ paths:
         #### Query Types
 
 
-        **Metric Alert Query**
+        ##### Metric Alert Query
 
 
         Example: `time_aggr(time_window):space_aggr:metric{tags} [by {key}] operator
@@ -24494,7 +24748,7 @@ paths:
         ''dbscan'', 7) > 0`
 
 
-        **Service Check Query**
+        ##### Service Check Query
 
 
         Example: `"check".over(tags).last(count).by(group).count_by_status()`
@@ -24520,7 +24774,7 @@ paths:
         for more information.
 
 
-        **Event Alert Query**
+        ##### Event Alert Query
 
 
         Example: `events(''sources:nagios status:error,warning priority:normal tags:
@@ -24556,7 +24810,7 @@ paths:
         V2 Alert Query. For more information, see the [Event Migration guide](https://docs.datadoghq.com/events/guides/migrating_to_new_events_features/).
 
 
-        **Event V2 Alert Query**
+        ##### Event V2 Alert Query
 
 
         Example: `events(query).rollup(rollup_method[, measure]).last(time_window)
@@ -24577,7 +24831,7 @@ paths:
         - `#` an integer or decimal number used to set the threshold.
 
 
-        **Process Alert Query**
+        ##### Process Alert Query
 
 
         Example: `processes(search).over(tags).rollup(''count'').last(timeframe) operator
@@ -24599,7 +24853,7 @@ paths:
         - `#` an integer or decimal number used to set the threshold
 
 
-        **Logs Alert Query**
+        ##### Logs Alert Query
 
 
         Example: `logs(query).index(index_name).rollup(rollup_method[, measure]).last(time_window)
@@ -24623,7 +24877,7 @@ paths:
         - `#` an integer or decimal number used to set the threshold.
 
 
-        **Composite Query**
+        ##### Composite Query
 
 
         Example: `12345 && 67890`, where `12345` and `67890` are the IDs of non-composite
@@ -24649,7 +24903,7 @@ paths:
         UI.
 
 
-        **SLO Alert Query**
+        ##### SLO Alert Query
 
 
         Example: `error_budget("slo_id").over("time_window") operator #`
@@ -24664,7 +24918,7 @@ paths:
         - `operator`: `>=` or `>`
 
 
-        **Audit Alert Query**
+        ##### Audit Alert Query
 
 
         Example: `audits(query).rollup(rollup_method[, measure]).last(time_window)
@@ -24689,7 +24943,7 @@ paths:
         and US5.
 
 
-        **CI Pipelines Alert Query**
+        ##### CI Pipelines Alert Query
 
 
         Example: `ci-pipelines(query).rollup(rollup_method[, measure]).last(time_window)
@@ -24714,7 +24968,7 @@ paths:
         **NOTE** CI Pipeline monitors are in alpha on US1, EU, AP1, US3, and US5.
 
 
-        **CI Tests Alert Query**
+        ##### CI Tests Alert Query
 
 
         Example: `ci-tests(query).rollup(rollup_method[, measure]).last(time_window)
@@ -24740,7 +24994,7 @@ paths:
         US3, and US5.
 
 
-        **Error Tracking Alert Query**
+        ##### Error Tracking Alert Query
 
 
         Example(RUM): `error-tracking-rum(query).rollup(rollup_method[, measure]).last(time_window)
@@ -25161,6 +25415,13 @@ paths:
         required: false
         schema:
           type: string
+      - description: If this argument is set to true, then the returned data includes
+          all current active downtimes for the monitor.
+        in: query
+        name: with_downtimes
+        required: false
+        schema:
+          type: boolean
       responses:
         '200':
           content:
@@ -27197,7 +27458,7 @@ paths:
       - Synthetics
   /api/v1/synthetics/private-locations:
     post:
-      description: Create a new Synthetics private location.
+      description: Create a new Synthetic private location.
       operationId: CreatePrivateLocation
       requestBody:
         content:
@@ -27238,7 +27499,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/private-locations/{location_id}:
     delete:
-      description: Delete a Synthetics private location.
+      description: Delete a Synthetic private location.
       operationId: DeletePrivateLocation
       parameters:
       - description: The ID of the private location.
@@ -27269,7 +27530,7 @@ paths:
       tags:
       - Synthetics
     get:
-      description: Get a Synthetics private location.
+      description: Get a Synthetic private location.
       operationId: GetPrivateLocation
       parameters:
       - description: The ID of the private location.
@@ -27304,7 +27565,7 @@ paths:
       tags:
       - Synthetics
     put:
-      description: Edit a Synthetics private location.
+      description: Edit a Synthetic private location.
       operationId: UpdatePrivateLocation
       parameters:
       - description: The ID of the private location.
@@ -27380,7 +27641,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: Synthetics is not activated for the user.
+          description: Synthetic Monitoring is not activated for the user.
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       security:
@@ -27742,7 +28003,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
+          description: '- Synthetic Monitoring is not activated for the user
 
             - Test is not owned by the user'
         '429':
@@ -27816,8 +28077,8 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/browser/{public_id}/results:
     get:
-      description: Get the last 150 test results summaries for a given Synthetics
-        Browser test.
+      description: Get the last 150 test results summaries for a given Synthetic browser
+        test.
       operationId: GetBrowserTestLatestResults
       parameters:
       - description: 'The public ID of the browser test for which to search results
@@ -27868,7 +28129,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
+          description: '- Synthetic Monitoring is not activated for the user
 
             - Test is not owned by the user'
         '429':
@@ -27884,7 +28145,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/browser/{public_id}/results/{result_id}:
     get:
-      description: Get a specific full result from a given (browser) Synthetic test.
+      description: Get a specific full result from a given Synthetic browser test.
       operationId: GetBrowserTestResult
       parameters:
       - description: 'The public ID of the browser test to which the target result
@@ -27919,7 +28180,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
+          description: '- Synthetic Monitoring is not activated for the user
 
             - Test or result is not owned by the user'
         '429':
@@ -27974,7 +28235,7 @@ paths:
                 $ref: '#/components/schemas/APIErrorResponse'
           description: '- Tests to be deleted can''t be found
 
-            - Synthetics is not activated for the user'
+            - Synthetic is not activated for the user'
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       security:
@@ -27988,7 +28249,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/trigger:
     post:
-      description: Trigger a set of Synthetics tests.
+      description: Trigger a set of Synthetic tests.
       operationId: TriggerTests
       requestBody:
         content:
@@ -28017,13 +28278,13 @@ paths:
         appKeyAuth: []
       - AuthZ:
         - synthetics_write
-      summary: Trigger Synthetics tests
+      summary: Trigger Synthetic tests
       tags:
       - Synthetics
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/trigger/ci:
     post:
-      description: Trigger a set of Synthetics tests for continuous integration.
+      description: Trigger a set of Synthetic tests for continuous integration.
       operationId: TriggerCITests
       requestBody:
         content:
@@ -28058,7 +28319,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/{public_id}:
     get:
-      description: Get the detailed configuration associated with a Synthetics test.
+      description: Get the detailed configuration associated with a Synthetic test.
       operationId: GetTest
       parameters:
       - description: The public ID of the test to get details from.
@@ -28100,8 +28361,8 @@ paths:
       - Synthetics
   /api/v1/synthetics/tests/{public_id}/results:
     get:
-      description: Get the last 150 test results summaries for a given Synthetics
-        API test.
+      description: Get the last 150 test results summaries for a given Synthetic API
+        test.
       operationId: GetAPITestLatestResults
       parameters:
       - description: The public ID of the test for which to search results for.
@@ -28166,7 +28427,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/tests/{public_id}/results/{result_id}:
     get:
-      description: Get a specific full result from a given (API) Synthetic test.
+      description: Get a specific full result from a given Synthetic API test.
       operationId: GetAPITestResult
       parameters:
       - description: The public ID of the API test to which the target result belongs.
@@ -28199,7 +28460,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
+          description: '- Synthetic Monitoring is not activated for the user
 
             - Test or result is not owned by the user'
         '429':
@@ -28214,7 +28475,7 @@ paths:
       - Synthetics
   /api/v1/synthetics/tests/{public_id}/status:
     put:
-      description: Pause or start a Synthetics test by changing the status.
+      description: Pause or start a Synthetic test by changing the status.
       operationId: UpdateTestPauseStatus
       parameters:
       - description: The public ID of the Synthetic test to update.
@@ -28254,7 +28515,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/APIErrorResponse'
-          description: '- Synthetic is not activated for the user
+          description: '- Synthetic Monitoring is not activated for the user
 
             - Test is not owned by the user'
         '429':
@@ -28270,7 +28531,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/variables:
     get:
-      description: Get the list of all Synthetics global variables.
+      description: Get the list of all Synthetic global variables.
       operationId: ListGlobalVariables
       responses:
         '200':
@@ -28296,7 +28557,7 @@ paths:
       tags:
       - Synthetics
     post:
-      description: Create a Synthetics global variable.
+      description: Create a Synthetic global variable.
       operationId: CreateGlobalVariable
       requestBody:
         content:
@@ -28337,7 +28598,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/synthetics/variables/{variable_id}:
     delete:
-      description: Delete a Synthetics global variable.
+      description: Delete a Synthetic global variable.
       operationId: DeleteGlobalVariable
       parameters:
       - description: The ID of the global variable.
@@ -28417,7 +28678,7 @@ paths:
       tags:
       - Synthetics
     put:
-      description: Edit a Synthetics global variable.
+      description: Edit a Synthetic global variable.
       operationId: EditGlobalVariable
       parameters:
       - description: The ID of the global variable.
@@ -31519,12 +31780,13 @@ tags:
   name: Slack Integration
 - description: Take graph snapshots using the API.
   name: Snapshots
-- description: "Datadog Synthetics uses simulated user requests and browser rendering
-    to help you ensure uptime,\nidentify regional issues, and track your application
-    performance. Datadog Synthetics tests come in\ntwo different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/?tab=httptest)\nand
-    [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can
-    use Datadog\u2019s API to\nmanage both test types programmatically.\n\nFor more
-    information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/)."
+- description: "Datadog Synthetic Monitoring uses simulated user requests and browser
+    rendering to help you ensure uptime,\nidentify regional issues, and track your
+    application performance. Synthetic tests come in\ntwo different flavors, [API
+    tests](https://docs.datadoghq.com/synthetics/api_tests/?tab=httptest)\nand [browser
+    tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog\u2019s
+    API to\nmanage both test types programmatically.\n\nFor more information, see
+    the [Synthetic Monitoring documentation](https://docs.datadoghq.com/synthetics/)."
   name: Synthetics
 - description: 'The tag endpoint allows you to assign tags to hosts,