datadog_api_client 2.52.0 → 2.53.0

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

@@ -991,6 +991,48 @@ components:
         scaling:
           $ref: "#/components/schemas/BarChartWidgetScaling"
       type: object
+    CalendarInterval:
+      additionalProperties: false
+      description: Calendar interval definition.
+      properties:
+        alignment:
+          description: Alignment of the interval. Valid values depend on the interval type. For `day`, use hours (for example, `1am`, `2pm`, or `14`). For `week`, use day names (for example, `monday`). For `month`, use day-of-month ordinals (for example, `1st`, `15th`). For `year` or `quarter`, use month names (for example, `january`).
+          example: "monday"
+          type: string
+        quantity:
+          description: Quantity of the interval.
+          example: 1
+          format: int64
+          type: integer
+        timezone:
+          description: Timezone for the interval.
+          example: "UTC"
+          type: string
+        type:
+          $ref: "#/components/schemas/CalendarIntervalType"
+      required:
+        - type
+      type: object
+    CalendarIntervalType:
+      description: Type of calendar interval.
+      enum:
+        - day
+        - week
+        - month
+        - year
+        - quarter
+        - minute
+        - hour
+      example: week
+      type: string
+      x-enum-varnames:
+        - DAY
+        - WEEK
+        - MONTH
+        - YEAR
+        - QUARTER
+        - MINUTE
+        - HOUR
     CancelDowntimesByScopeRequest:
       description: Cancel downtimes according to scope.
       properties:
@@ -1235,6 +1277,69 @@ components:
       type: string
       x-enum-varnames:
         - CHECK_STATUS
+    CohortWidgetDefinition:
+      additionalProperties: false
+      description: The cohort widget visualizes user retention over time.
+      properties:
+        description:
+          description: The description of the widget.
+          type: string
+        requests:
+          description: List of Cohort widget requests.
+          example:
+            - query:
+                compute:
+                  aggregation: count
+                  metric: __dd.retention_rate
+                data_source: product_analytics_retention
+                search:
+                  cohort_criteria:
+                    base_query:
+                      data_source: product_analytics
+                      search:
+                        query: "@type:view @view.name:/home"
+                    time_interval:
+                      type: calendar
+                      value:
+                        type: week
+                  retention_entity: "@usr.id"
+                  return_condition: conversion_on_or_after
+                  return_criteria:
+                    base_query:
+                      data_source: product_analytics
+                      search:
+                        query: "@type:view @view.name:/checkout"
+              request_type: retention_grid
+          items:
+            $ref: "#/components/schemas/RetentionGridRequest"
+            description: A cohort widget request.
+          minItems: 1
+          type: array
+        time:
+          $ref: "#/components/schemas/WidgetTime"
+        title:
+          description: Title of your widget.
+          type: string
+        title_align:
+          $ref: "#/components/schemas/WidgetTextAlign"
+        title_size:
+          description: Size of the title.
+          type: string
+        type:
+          $ref: "#/components/schemas/CohortWidgetDefinitionType"
+      required:
+        - type
+        - requests
+      type: object
+    CohortWidgetDefinitionType:
+      default: cohort
+      description: Type of the Cohort widget.
+      enum:
+        - cohort
+      example: cohort
+      type: string
+      x-enum-varnames:
+        - COHORT
     ContentEncoding:
       description: HTTP header used to compress the media-type.
       enum:
@@ -2782,6 +2887,7 @@ components:
         peer_tags:
           description: Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.).
           items:
+            description: "A tag identifying a specific downstream entity (for example: peer.service, peer.db_instance)."
             example: "peer.service:my-service"
             type: string
           type: array
@@ -3247,6 +3353,54 @@ components:
         - metric
         - name
       type: object
+    FormulaAndFunctionProductAnalyticsExtendedDataSource:
+      description: Data source for Product Analytics Extended queries.
+      enum:
+        - product_analytics_extended
+      example: product_analytics_extended
+      type: string
+      x-enum-varnames:
+        - PRODUCT_ANALYTICS_EXTENDED
+    FormulaAndFunctionProductAnalyticsExtendedQueryDefinition:
+      description: A formula and functions Product Analytics Extended query for advanced analytics features.
+      properties:
+        audience_filters:
+          $ref: "#/components/schemas/ProductAnalyticsAudienceFilters"
+        compute:
+          $ref: "#/components/schemas/ProductAnalyticsExtendedCompute"
+        data_source:
+          $ref: "#/components/schemas/FormulaAndFunctionProductAnalyticsExtendedDataSource"
+        group_by:
+          description: Group by configuration.
+          items:
+            $ref: "#/components/schemas/ProductAnalyticsExtendedGroupBy"
+            description: A Product Analytics Extended group by configuration.
+          type: array
+        indexes:
+          description: Event indexes to query.
+          example: ["*"]
+          items:
+            $ref: "#/components/schemas/FormulaAndFunctionProductAnalyticsExtendedQueryDefinitionIndexesItems"
+          type: array
+        name:
+          description: Name of the query for use in formulas.
+          example: "query1"
+          type: string
+        query:
+          $ref: "#/components/schemas/ProductAnalyticsBaseQuery"
+      required:
+        - data_source
+        - name
+        - query
+        - compute
+      type: object
+    FormulaAndFunctionProductAnalyticsExtendedQueryDefinitionIndexesItems:
+      description: Use `"*"` to query all indexes.
+      enum:
+        - "*"
+      type: string
+      x-enum-varnames:
+        - ALL
     FormulaAndFunctionQueryDefinition:
       description: A formula and function query.
       oneOf:
@@ -3258,6 +3412,9 @@ components:
         - $ref: "#/components/schemas/FormulaAndFunctionApmMetricsQueryDefinition"
         - $ref: "#/components/schemas/FormulaAndFunctionSLOQueryDefinition"
         - $ref: "#/components/schemas/FormulaAndFunctionCloudCostQueryDefinition"
+        - $ref: "#/components/schemas/FormulaAndFunctionProductAnalyticsExtendedQueryDefinition"
+        - $ref: "#/components/schemas/FormulaAndFunctionUserJourneyQueryDefinition"
+        - $ref: "#/components/schemas/FormulaAndFunctionRetentionQueryDefinition"
     FormulaAndFunctionResponseFormat:
       description: Timeseries, scalar, or event list response. Event list response formats are supported by Geomap widgets.
       enum:
@@ -3270,6 +3427,31 @@ components:
         - TIMESERIES
         - SCALAR
         - EVENT_LIST
+    FormulaAndFunctionRetentionQueryDefinition:
+      description: A formula and functions Retention query for defining timeseries and scalar visualizations.
+      properties:
+        compute:
+          $ref: "#/components/schemas/RetentionCompute"
+        data_source:
+          $ref: "#/components/schemas/RetentionDataSource"
+        group_by:
+          description: Group by configuration.
+          items:
+            $ref: "#/components/schemas/RetentionGroupBy"
+            description: A Retention group by configuration.
+          type: array
+        name:
+          description: Name of the query for use in formulas.
+          example: "query1"
+          type: string
+        search:
+          $ref: "#/components/schemas/RetentionSearch"
+      required:
+        - data_source
+        - name
+        - search
+        - compute
+      type: object
     FormulaAndFunctionSLODataSource:
       description: Data source for SLO measures queries.
       enum:
@@ -3360,6 +3542,31 @@ components:
         - METRIC
         - MONITOR
         - TIME_SLICE
+    FormulaAndFunctionUserJourneyQueryDefinition:
+      description: A formula and functions User Journey query for defining funnel, timeseries, and scalar visualizations over journey data.
+      properties:
+        compute:
+          $ref: "#/components/schemas/UserJourneyFormulaCompute"
+        data_source:
+          $ref: "#/components/schemas/ProductAnalyticsFunnelDataSource"
+        group_by:
+          description: Group by configuration.
+          items:
+            $ref: "#/components/schemas/UserJourneyFormulaGroupBy"
+            description: A User Journey group by configuration.
+          type: array
+        name:
+          description: Name of the query for use in formulas.
+          example: "query1"
+          type: string
+        search:
+          $ref: "#/components/schemas/UserJourneySearch"
+      required:
+        - data_source
+        - name
+        - search
+        - compute
+      type: object
     FormulaType:
       description: Set the sort type to formula.
       enum: ["formula"]
@@ -3399,6 +3606,61 @@ components:
       type: string
       x-enum-varnames:
         - FREE_TEXT
+    FunnelComparisonCustomTimeframe:
+      additionalProperties: false
+      description: Custom timeframe for funnel comparison.
+      properties:
+        from:
+          description: Start of the custom timeframe.
+          example: 0.0
+          format: double
+          type: number
+        to:
+          description: End of the custom timeframe.
+          example: 0.0
+          format: double
+          type: number
+      required:
+        - from
+        - to
+      type: object
+    FunnelComparisonDuration:
+      additionalProperties: false
+      description: Comparison time configuration for funnel widgets.
+      properties:
+        custom_timeframe:
+          $ref: "#/components/schemas/FunnelComparisonCustomTimeframe"
+        type:
+          $ref: "#/components/schemas/FunnelComparisonDurationType"
+      required:
+        - type
+      type: object
+    FunnelComparisonDurationType:
+      description: Type of comparison duration.
+      enum:
+        - previous_timeframe
+        - custom_timeframe
+        - previous_day
+        - previous_week
+        - previous_month
+      example: previous_timeframe
+      type: string
+      x-enum-varnames:
+        - PREVIOUS_TIMEFRAME
+        - CUSTOM_TIMEFRAME
+        - PREVIOUS_DAY
+        - PREVIOUS_WEEK
+        - PREVIOUS_MONTH
+    FunnelGroupedDisplay:
+      description: Display mode for grouped funnel results.
+      enum:
+        - stacked
+        - side_by_side
+      example: stacked
+      type: string
+      x-enum-varnames:
+        - STACKED
+        - SIDE_BY_SIDE
     FunnelQuery:
       description: Updated funnel widget.
       properties:
@@ -3457,12 +3719,13 @@ components:
         description:
           description: The description of the widget.
           type: string
+        grouped_display:
+          $ref: "#/components/schemas/FunnelGroupedDisplay"
         requests:
           description: Request payload used to query items.
           example: [{"query": {"data_source": "rum", "query_string": "@browser.name:Chrome", "steps": [{"facet": "@view.name", "value": "/logs"}, {"facet": "@view.name", "value": "/apm/home"}]}, "request_type": "funnel"}]
           items:
             $ref: "#/components/schemas/FunnelWidgetRequest"
-          maxItems: 1
           minItems: 1
           type: array
         time:
@@ -6647,6 +6910,7 @@ components:
         sources:
           additionalProperties:
             items:
+              description: A fallback source attribute name.
               type: string
             type: array
           description: Fallback sources used to populate value of field.
@@ -6695,6 +6959,7 @@ components:
           description: Optional list of profiles to modify the schema.
           example: ["security_control", "host"]
           items:
+            description: A profile name that modifies the schema behavior.
             type: string
           type: array
         schema_type:
@@ -7808,6 +8073,7 @@ components:
           description: Columns to group results by.
           example: ["col1", "col2"]
           items:
+            description: A column name to group results by.
             type: string
           type: array
         model_type_override:
@@ -7827,6 +8093,7 @@ components:
           description: Optional grouping fields for aggregation.
           example: ["entity_id"]
           items:
+            description: A field name to group results by.
             type: string
           type: array
         measure:
@@ -11161,8 +11428,10 @@ components:
       description: Product Analytics audience account subquery.
       properties:
         name:
+          description: The name of the account subquery.
           type: string
         query:
+          description: The query string for the account subquery.
           type: string
       type: object
     ProductAnalyticsAudienceFilters:
@@ -11173,6 +11442,7 @@ components:
             $ref: "#/components/schemas/ProductAnalyticsAudienceAccountSubquery"
           type: array
         filter_condition:
+          description: An optional filter condition applied to the audience subquery.
           type: string
         segments:
           items:
@@ -11184,28 +11454,298 @@ components:
           type: array
       type: object
     ProductAnalyticsAudienceOccurrenceFilter:
+      description: Filter applied to occurrence counts when building a Product Analytics audience.
       properties:
         operator:
+          description: "The comparison operator used for the occurrence filter (for example: `gt`, `lt`, `eq`)."
           type: string
         value:
+          description: The threshold value to compare occurrence counts against.
           type: string
       type: object
     ProductAnalyticsAudienceSegmentSubquery:
       description: Product Analytics audience segment subquery.
       properties:
         name:
+          description: The name of the segment subquery.
           type: string
         segment_id:
+          description: The unique identifier of the segment.
           type: string
       type: object
     ProductAnalyticsAudienceUserSubquery:
       description: Product Analytics audience user subquery.
       properties:
         name:
+          description: The name of the user subquery.
           type: string
         query:
+          description: The query string for the user subquery.
           type: string
       type: object
+    ProductAnalyticsBaseQuery:
+      $ref: "#/components/schemas/ProductAnalyticsEventQuery"
+      description: Base query for Product Analytics.
+    ProductAnalyticsEventDataSource:
+      description: Data source for Product Analytics event queries.
+      enum:
+        - product_analytics
+      example: product_analytics
+      type: string
+      x-enum-varnames:
+        - PRODUCT_ANALYTICS
+    ProductAnalyticsEventQuery:
+      additionalProperties: false
+      description: Product Analytics event query.
+      properties:
+        data_source:
+          $ref: "#/components/schemas/ProductAnalyticsEventDataSource"
+        search:
+          $ref: "#/components/schemas/ProductAnalyticsEventQuerySearch"
+      required:
+        - data_source
+        - search
+      type: object
+    ProductAnalyticsEventQuerySearch:
+      additionalProperties: false
+      description: Search configuration for Product Analytics event query.
+      properties:
+        query:
+          description: RUM event search query used to filter views or actions.
+          example: "@type:view @view.name:/home"
+          type: string
+      required:
+        - query
+      type: object
+    ProductAnalyticsExtendedCompute:
+      additionalProperties: false
+      description: Compute configuration for Product Analytics Extended queries.
+      properties:
+        aggregation:
+          $ref: "#/components/schemas/FormulaAndFunctionEventAggregation"
+        interval:
+          description: Fixed-width time bucket interval in milliseconds for time series queries. Mutually exclusive with `rollup`.
+          example: 60000
+          format: double
+          type: number
+        metric:
+          description: Measurable attribute to compute.
+          example: "@usr.id"
+          type: string
+        name:
+          description: Name of the compute for use in formulas.
+          example: "query1"
+          type: string
+        rollup:
+          $ref: "#/components/schemas/CalendarInterval"
+          description: Calendar-aligned time bucket for time series queries (for example, day, week, or month boundaries). Mutually exclusive with `interval`.
+      required:
+        - aggregation
+      type: object
+    ProductAnalyticsExtendedGroupBy:
+      description: Group by configuration for Product Analytics Extended queries.
+      properties:
+        facet:
+          description: Facet name to group by.
+          example: "@geo.country"
+          type: string
+        limit:
+          description: Maximum number of groups to return.
+          example: 10
+          format: int32
+          maximum: 10000
+          type: integer
+        should_exclude_missing:
+          description: Whether to exclude events missing the group-by facet.
+          type: boolean
+        sort:
+          $ref: "#/components/schemas/FormulaAndFunctionEventQueryGroupBySort"
+      required:
+        - facet
+      type: object
+    ProductAnalyticsFunnelCompute:
+      additionalProperties: false
+      description: Compute configuration for user journey funnel.
+      properties:
+        aggregation:
+          $ref: "#/components/schemas/ProductAnalyticsFunnelComputeAggregation"
+        metric:
+          $ref: "#/components/schemas/ProductAnalyticsFunnelComputeMetric"
+      required:
+        - aggregation
+        - metric
+      type: object
+    ProductAnalyticsFunnelComputeAggregation:
+      description: Aggregation type for user journey funnel compute.
+      enum:
+        - cardinality
+        - count
+      example: count
+      type: string
+      x-enum-varnames:
+        - CARDINALITY
+        - COUNT
+    ProductAnalyticsFunnelComputeMetric:
+      description: Metric for user journey funnel compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` (unique users/sessions) and `cardinality` (total users/sessions) as aggregations.
+      enum:
+        - __dd.conversion
+        - __dd.conversion_rate
+      example: __dd.conversion_rate
+      type: string
+      x-enum-varnames:
+        - CONVERSION
+        - CONVERSION_RATE
+    ProductAnalyticsFunnelDataSource:
+      description: Data source for user journey funnel queries.
+      enum:
+        - product_analytics_journey
+      example: product_analytics_journey
+      type: string
+      x-enum-varnames:
+        - PRODUCT_ANALYTICS_JOURNEY
+    ProductAnalyticsFunnelGroupBy:
+      description: Group by configuration for user journey funnel.
+      properties:
+        facet:
+          description: Facet to group by.
+          example: "@usr.email"
+          type: string
+        limit:
+          description: Maximum number of groups.
+          format: int64
+          type: integer
+        should_exclude_missing:
+          description: Whether to exclude missing values.
+          type: boolean
+        sort:
+          $ref: "#/components/schemas/ProductAnalyticsFunnelGroupBySort"
+        target:
+          $ref: "#/components/schemas/UserJourneySearchTarget"
+      required:
+        - facet
+      type: object
+    ProductAnalyticsFunnelGroupBySort:
+      additionalProperties: false
+      description: Sort configuration for user journey funnel group by.
+      properties:
+        aggregation:
+          description: Aggregation type.
+          example: "count"
+          type: string
+        metric:
+          description: Metric to sort by.
+          example: "@session.id"
+          type: string
+        order:
+          $ref: "#/components/schemas/WidgetSort"
+      required:
+        - aggregation
+      type: object
+    ProductAnalyticsFunnelQuery:
+      additionalProperties: false
+      description: User journey funnel query definition.
+      properties:
+        compute:
+          $ref: "#/components/schemas/ProductAnalyticsFunnelCompute"
+        data_source:
+          $ref: "#/components/schemas/ProductAnalyticsFunnelDataSource"
+        group_by:
+          description: Group by configuration.
+          items:
+            $ref: "#/components/schemas/ProductAnalyticsFunnelGroupBy"
+            description: A user journey funnel group by configuration.
+          type: array
+        search:
+          $ref: "#/components/schemas/UserJourneySearch"
+        subquery_id:
+          description: Subquery ID.
+          type: string
+      required:
+        - data_source
+        - search
+      type: object
+    ProductAnalyticsFunnelRequest:
+      additionalProperties: false
+      description: User journey funnel widget request.
+      properties:
+        comparison_segments:
+          description: Comparison segments.
+          items:
+            description: Segment identifier.
+            minLength: 1
+            type: string
+          minItems: 1
+          type: array
+        comparison_time:
+          $ref: "#/components/schemas/FunnelComparisonDuration"
+        query:
+          $ref: "#/components/schemas/ProductAnalyticsFunnelQuery"
+        request_type:
+          $ref: "#/components/schemas/ProductAnalyticsFunnelRequestType"
+      required:
+        - query
+        - request_type
+      type: object
+    ProductAnalyticsFunnelRequestType:
+      description: Request type for user journey funnel widget.
+      enum:
+        - user_journey_funnel
+      example: user_journey_funnel
+      type: string
+      x-enum-varnames:
+        - USER_JOURNEY_FUNNEL
+    ProductAnalyticsFunnelWidgetDefinition:
+      additionalProperties: false
+      description: The user journey funnel visualization displays conversion funnels based on user journey data from Product Analytics.
+      properties:
+        description:
+          description: The description of the widget.
+          type: string
+        grouped_display:
+          $ref: "#/components/schemas/FunnelGroupedDisplay"
+        requests:
+          description: Request payload used to query items.
+          example:
+            - query:
+                compute:
+                  aggregation: cardinality
+                  metric: __dd.conversion
+                data_source: product_analytics_journey
+                search:
+                  expression: "step1 -> step2"
+                  filters:
+                    string_filter: "@application.id:xxx @geo.country:France"
+                  node_objects:
+                    step1:
+                      data_source: product_analytics
+                      search:
+                        query: "@type:view @view.name:/home"
+                    step2:
+                      data_source: product_analytics
+                      search:
+                        query: '@type:action @action.name:"add to cart"'
+              request_type: user_journey_funnel
+          items:
+            $ref: "#/components/schemas/ProductAnalyticsFunnelRequest"
+            description: A user journey funnel widget request.
+          minItems: 1
+          type: array
+        time:
+          $ref: "#/components/schemas/WidgetTime"
+        title:
+          description: The title of the widget.
+          type: string
+        title_align:
+          $ref: "#/components/schemas/WidgetTextAlign"
+        title_size:
+          description: The size of the title.
+          type: string
+        type:
+          $ref: "#/components/schemas/FunnelWidgetDefinitionType"
+      required:
+        - type
+        - requests
+      type: object
     QuerySortOrder:
       default: desc
       description: Direction of sort.
@@ -11394,6 +11934,354 @@ components:
         page:
           $ref: "#/components/schemas/Pagination"
       type: object
+    RetentionCohortCriteria:
+      additionalProperties: false
+      description: Cohort criteria for retention queries.
+      properties:
+        base_query:
+          $ref: "#/components/schemas/ProductAnalyticsBaseQuery"
+        time_interval:
+          $ref: "#/components/schemas/RetentionCohortCriteriaTimeInterval"
+      required:
+        - base_query
+        - time_interval
+      type: object
+    RetentionCohortCriteriaTimeInterval:
+      additionalProperties: false
+      description: Time interval for cohort criteria.
+      properties:
+        type:
+          $ref: "#/components/schemas/RetentionCohortCriteriaTimeIntervalType"
+        value:
+          $ref: "#/components/schemas/CalendarInterval"
+      required:
+        - type
+        - value
+      type: object
+    RetentionCohortCriteriaTimeIntervalType:
+      description: Type of time interval for cohort criteria.
+      enum:
+        - calendar
+      example: calendar
+      type: string
+      x-enum-varnames:
+        - CALENDAR
+    RetentionCompute:
+      additionalProperties: false
+      description: Compute configuration for retention queries.
+      properties:
+        aggregation:
+          $ref: "#/components/schemas/EventsAggregation"
+        metric:
+          $ref: "#/components/schemas/RetentionComputeMetric"
+      required:
+        - aggregation
+        - metric
+      type: object
+    RetentionComputeMetric:
+      description: Metric for retention compute.
+      enum:
+        - __dd.retention
+        - __dd.retention_rate
+      example: __dd.retention_rate
+      type: string
+      x-enum-varnames:
+        - RETENTION
+        - RETENTION_RATE
+    RetentionCurveRequestType:
+      description: Request type for retention curve widget.
+      enum:
+        - retention_curve
+      example: retention_curve
+      type: string
+      x-enum-varnames:
+        - RETENTION_CURVE
+    RetentionCurveStyle:
+      additionalProperties: false
+      description: Style configuration for retention curve.
+      properties:
+        palette:
+          description: Color palette for the retention curve.
+          example: "dog_classic"
+          type: string
+      type: object
+    RetentionCurveWidgetDefinition:
+      additionalProperties: false
+      description: The retention curve widget visualizes user retention rates over time.
+      properties:
+        description:
+          description: The description of the widget.
+          type: string
+        requests:
+          description: List of Retention Curve widget requests.
+          example:
+            - query:
+                compute:
+                  aggregation: count
+                  metric: __dd.retention_rate
+                data_source: product_analytics_retention
+                search:
+                  cohort_criteria:
+                    base_query:
+                      data_source: product_analytics
+                      search:
+                        query: "@type:view @view.name:/home"
+                    time_interval:
+                      type: calendar
+                      value:
+                        type: week
+                  retention_entity: "@usr.id"
+                  return_condition: conversion_on_or_after
+                  return_criteria:
+                    base_query:
+                      data_source: product_analytics
+                      search:
+                        query: "@type:view @view.name:/checkout"
+              request_type: retention_curve
+          items:
+            $ref: "#/components/schemas/RetentionCurveWidgetRequest"
+            description: A retention curve widget request.
+          minItems: 1
+          type: array
+        time:
+          $ref: "#/components/schemas/WidgetTime"
+        title:
+          description: Title of your widget.
+          type: string
+        title_align:
+          $ref: "#/components/schemas/WidgetTextAlign"
+        title_size:
+          description: Size of the title.
+          type: string
+        type:
+          $ref: "#/components/schemas/RetentionCurveWidgetDefinitionType"
+      required:
+        - type
+        - requests
+      type: object
+    RetentionCurveWidgetDefinitionType:
+      default: retention_curve
+      description: Type of the Retention Curve widget.
+      enum:
+        - retention_curve
+      example: retention_curve
+      type: string
+      x-enum-varnames:
+        - RETENTION_CURVE
+    RetentionCurveWidgetRequest:
+      additionalProperties: false
+      description: Retention curve widget request.
+      properties:
+        query:
+          $ref: "#/components/schemas/RetentionQuery"
+        request_type:
+          $ref: "#/components/schemas/RetentionCurveRequestType"
+        style:
+          $ref: "#/components/schemas/RetentionCurveStyle"
+      required:
+        - request_type
+        - query
+      type: object
+    RetentionDataSource:
+      description: Data source for retention queries.
+      enum:
+        - product_analytics_retention
+      example: product_analytics_retention
+      type: string
+      x-enum-varnames:
+        - PRODUCT_ANALYTICS_RETENTION
+    RetentionEntity:
+      description: Entity to track for retention.
+      enum:
+        - "@usr.id"
+        - "@account.id"
+      example: "@usr.id"
+      type: string
+      x-enum-varnames:
+        - USER_ID
+        - ACCOUNT_ID
+    RetentionFilters:
+      additionalProperties: false
+      description: Filters for retention queries.
+      properties:
+        audience_filters:
+          $ref: "#/components/schemas/ProductAnalyticsAudienceFilters"
+        string_filter:
+          description: String filter.
+          example: "@session.type:user"
+          type: string
+      type: object
+    RetentionGridRequest:
+      additionalProperties: false
+      description: Retention grid widget request.
+      properties:
+        query:
+          $ref: "#/components/schemas/RetentionQuery"
+        request_type:
+          $ref: "#/components/schemas/RetentionGridRequestType"
+      required:
+        - request_type
+        - query
+      type: object
+    RetentionGridRequestType:
+      description: Request type for retention grid widget.
+      enum:
+        - retention_grid
+      example: retention_grid
+      type: string
+      x-enum-varnames:
+        - RETENTION_GRID
+    RetentionGroupBy:
+      additionalProperties: false
+      description: Group by configuration for retention queries.
+      properties:
+        facet:
+          description: Facet to group by.
+          example: "@geo.country"
+          type: string
+        limit:
+          description: Maximum number of groups.
+          example: 10
+          format: int64
+          type: integer
+        should_exclude_missing:
+          description: Whether to exclude missing values.
+          example: false
+          type: boolean
+        sort:
+          $ref: "#/components/schemas/RetentionGroupBySort"
+        source:
+          description: Source field.
+          example: "@geo.country"
+          type: string
+        target:
+          $ref: "#/components/schemas/RetentionGroupByTarget"
+      required:
+        - target
+        - facet
+      type: object
+    RetentionGroupBySort:
+      additionalProperties: false
+      description: Sort configuration for retention group by.
+      properties:
+        order:
+          $ref: "#/components/schemas/WidgetSort"
+      type: object
+    RetentionGroupByTarget:
+      description: Target for retention group by.
+      enum:
+        - cohort
+        - return_period
+      example: cohort
+      type: string
+      x-enum-varnames:
+        - COHORT
+        - RETURN_PERIOD
+    RetentionQuery:
+      additionalProperties: false
+      description: Retention query definition.
+      properties:
+        compute:
+          $ref: "#/components/schemas/RetentionCompute"
+        data_source:
+          $ref: "#/components/schemas/RetentionDataSource"
+        filters:
+          $ref: "#/components/schemas/RetentionFilters"
+        group_by:
+          description: Group by configuration.
+          items:
+            $ref: "#/components/schemas/RetentionGroupBy"
+            description: A retention group by configuration.
+          type: array
+        name:
+          description: Name of the query.
+          example: "retention_query"
+          type: string
+        search:
+          $ref: "#/components/schemas/RetentionSearch"
+      required:
+        - data_source
+        - search
+        - compute
+      type: object
+    RetentionReturnCondition:
+      description: Condition for counting user return.
+      enum:
+        - conversion_on
+        - conversion_on_or_after
+      example: conversion_on_or_after
+      type: string
+      x-enum-varnames:
+        - CONVERSION_ON
+        - CONVERSION_ON_OR_AFTER
+    RetentionReturnCriteria:
+      additionalProperties: false
+      description: Return criteria for retention queries.
+      properties:
+        base_query:
+          $ref: "#/components/schemas/ProductAnalyticsBaseQuery"
+        time_interval:
+          $ref: "#/components/schemas/RetentionReturnCriteriaTimeInterval"
+      required:
+        - base_query
+      type: object
+    RetentionReturnCriteriaTimeInterval:
+      additionalProperties: false
+      description: Time interval for return criteria.
+      properties:
+        type:
+          $ref: "#/components/schemas/RetentionReturnCriteriaTimeIntervalType"
+        unit:
+          $ref: "#/components/schemas/RetentionReturnCriteriaTimeIntervalUnit"
+        value:
+          description: Value of the time interval.
+          example: 0.0
+          format: double
+          type: number
+      required:
+        - type
+        - value
+        - unit
+      type: object
+    RetentionReturnCriteriaTimeIntervalType:
+      description: Type of time interval for return criteria.
+      enum:
+        - fixed
+      example: fixed
+      type: string
+      x-enum-varnames:
+        - FIXED
+    RetentionReturnCriteriaTimeIntervalUnit:
+      description: Unit of time for retention return criteria interval.
+      enum:
+        - day
+        - week
+        - month
+      example: day
+      type: string
+      x-enum-varnames:
+        - DAY
+        - WEEK
+        - MONTH
+    RetentionSearch:
+      additionalProperties: false
+      description: Search configuration for retention queries.
+      properties:
+        cohort_criteria:
+          $ref: "#/components/schemas/RetentionCohortCriteria"
+        filters:
+          $ref: "#/components/schemas/RetentionFilters"
+        retention_entity:
+          $ref: "#/components/schemas/RetentionEntity"
+        return_condition:
+          $ref: "#/components/schemas/RetentionReturnCondition"
+        return_criteria:
+          $ref: "#/components/schemas/RetentionReturnCriteria"
+      required:
+        - cohort_criteria
+        - retention_entity
+        - return_condition
+      type: object
     RunWorkflowWidgetDefinition:
       description: Run workflow is widget that allows you to run a workflow from a dashboard.
       properties:
@@ -11772,6 +12660,7 @@ components:
         - $ref: "#/components/schemas/SLOCountDefinitionWithBadEventsFormula"
     SLOCountDefinitionWithBadEventsFormula:
       additionalProperties: false
+      description: SLO count definition using a bad events formula alongside a good events formula.
       properties:
         bad_events_formula:
           $ref: "#/components/schemas/SLOFormula"
@@ -11798,6 +12687,7 @@ components:
       type: object
     SLOCountDefinitionWithTotalEventsFormula:
       additionalProperties: false
+      description: SLO count definition using a total events formula alongside a good events formula.
       properties:
         good_events_formula:
           $ref: "#/components/schemas/SLOFormula"
@@ -13004,6 +13894,7 @@ components:
           description: Fields to group by.
           example: ["source", "destination"]
           items:
+            description: A field name to group by.
             type: string
           type: array
         limit:
@@ -13115,7 +14006,7 @@ components:
         occurrences:
           $ref: "#/components/schemas/ProductAnalyticsAudienceOccurrenceFilter"
         query_string:
-          description: Query string.
+          description: RUM event search query used to filter views or actions.
           example: "@type:view"
           type: string
         source:
@@ -13626,6 +14517,7 @@ components:
             Always included in service level objective responses (but may be empty).
           example: ["env:prod", "app:core"]
           items:
+            description: A tag associated with the service level objective.
             type: string
           type: array
         created_at:
@@ -13649,6 +14541,7 @@ components:
         env_tags:
           description: Tags with the `env` tag key.
           items:
+            description: A tag with the `env` tag key.
             type: string
           type: array
         groups:
@@ -13693,6 +14586,7 @@ components:
         service_tags:
           description: Tags with the `service` tag key.
           items:
+            description: A tag with the `service` tag key.
             type: string
           type: array
         slo_type:
@@ -13702,6 +14596,7 @@ components:
         team_tags:
           description: Tags with the `team` tag key.
           items:
+            description: A tag with the `team` tag key.
             type: string
           type: array
         thresholds:
@@ -14712,6 +15607,7 @@ components:
           description: The tag values.
           example: ["env"]
           items:
+            description: A tag value string.
             minLength: 1
             type: string
           type: array
@@ -17712,6 +18608,8 @@ components:
         - assertPageLacks
         - assertRequests
         - click
+        - drag
+        - drop
         - extractFromJavascript
         - extractFromEmailBody
         - extractVariable
@@ -17742,6 +18640,8 @@ components:
         - ASSERT_PAGE_LACKS
         - ASSERT_REQUESTS
         - CLICK
+        - DRAG
+        - DROP
         - EXTRACT_FROM_JAVASCRIPT
         - EXTRACT_FROM_EMAIL_BODY
         - EXTRACT_VARIABLE
@@ -17985,6 +18885,7 @@ components:
         blockedRequestPatterns:
           description: Array of URL patterns to block.
           items:
+            description: A URL pattern to block during the Synthetic test.
             type: string
           type: array
         checkCertificateRevocation:
@@ -21077,6 +21978,58 @@ components:
           description: Shows the sum of all browser RUM units over all hours in the current date for all organizations (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
+        ccm_anthropic_spend_last:
+          description: Shows the last value of Anthropic cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_aws_spend_last:
+          description: Shows the last value of AWS cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_azure_spend_last:
+          description: Shows the last value of Azure cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_confluent_spend_last:
+          description: Shows the last value of Confluent cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_databricks_spend_last:
+          description: Shows the last value of Databricks cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_elastic_spend_last:
+          description: Shows the last value of Elastic cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_fastly_spend_last:
+          description: Shows the last value of Fastly cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_gcp_spend_last:
+          description: Shows the last value of GCP cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_github_spend_last:
+          description: Shows the last value of GitHub cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_mongodb_spend_last:
+          description: Shows the last value of MongoDB cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_oci_spend_last:
+          description: Shows the last value of OCI cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_openai_spend_last:
+          description: Shows the last value of OpenAI cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
+        ccm_snowflake_spend_last:
+          description: Shows the last value of Snowflake cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
         ccm_spend_monitored_ent_last:
           description: Shows the last value of the amount of cloud spend monitored for Enterprise over all hours in the current date for all organizations.
           format: int64
@@ -21085,6 +22038,10 @@ components:
           description: Shows the last value of the amount of cloud spend monitored for Pro over all hours in the current date for all organizations.
           format: int64
           type: integer
+        ccm_twilio_spend_last:
+          description: Shows the last value of Twilio cloud spend monitored over all hours in the current date for all organizations.
+          format: int64
+          type: integer
         ci_pipeline_indexed_spans_sum:
           description: Shows the sum of all CI pipeline indexed spans over all hours in the current month for all organizations.
           format: int64
@@ -21966,6 +22923,58 @@ components:
           description: Shows the sum of all browser RUM units over all hours in the current date for the given org (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
+        ccm_anthropic_spend_last:
+          description: Shows the last value of Anthropic cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_aws_spend_last:
+          description: Shows the last value of AWS cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_azure_spend_last:
+          description: Shows the last value of Azure cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_confluent_spend_last:
+          description: Shows the last value of Confluent cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_databricks_spend_last:
+          description: Shows the last value of Databricks cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_elastic_spend_last:
+          description: Shows the last value of Elastic cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_fastly_spend_last:
+          description: Shows the last value of Fastly cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_gcp_spend_last:
+          description: Shows the last value of GCP cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_github_spend_last:
+          description: Shows the last value of GitHub cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_mongodb_spend_last:
+          description: Shows the last value of MongoDB cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_oci_spend_last:
+          description: Shows the last value of OCI cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_openai_spend_last:
+          description: Shows the last value of OpenAI cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
+        ccm_snowflake_spend_last:
+          description: Shows the last value of Snowflake cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
         ccm_spend_monitored_ent_last:
           description: Shows the last value of the amount of cloud spend monitored for Enterprise over all hours in the current date for the given org.
           format: int64
@@ -21974,6 +22983,10 @@ components:
           description: Shows the last value of the amount of cloud spend monitored for Pro over all hours in the current date for the given org.
           format: int64
           type: integer
+        ccm_twilio_spend_last:
+          description: Shows the last value of Twilio cloud spend monitored over all hours in the current date for the given org.
+          format: int64
+          type: integer
         ci_pipeline_indexed_spans_sum:
           description: Shows the sum of all CI pipeline indexed spans over all hours in the current date for the given org.
           format: int64
@@ -22865,6 +23878,58 @@ components:
           description: Shows the sum of all browser RUM units over all hours in the current month for all organizations (To be deprecated on October 1st, 2024).
           format: int64
           type: integer
+        ccm_anthropic_spend_last_sum:
+          description: Shows the sum of the last value of Anthropic cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_aws_spend_last_sum:
+          description: Shows the sum of the last value of AWS cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_azure_spend_last_sum:
+          description: Shows the sum of the last value of Azure cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_confluent_spend_last_sum:
+          description: Shows the sum of the last value of Confluent cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_databricks_spend_last_sum:
+          description: Shows the sum of the last value of Databricks cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_elastic_spend_last_sum:
+          description: Shows the sum of the last value of Elastic cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_fastly_spend_last_sum:
+          description: Shows the sum of the last value of Fastly cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_gcp_spend_last_sum:
+          description: Shows the sum of the last value of GCP cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_github_spend_last_sum:
+          description: Shows the sum of the last value of GitHub cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_mongodb_spend_last_sum:
+          description: Shows the sum of the last value of MongoDB cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_oci_spend_last_sum:
+          description: Shows the sum of the last value of OCI cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_openai_spend_last_sum:
+          description: Shows the sum of the last value of OpenAI cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
+        ccm_snowflake_spend_last_sum:
+          description: Shows the sum of the last value of Snowflake cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
         ccm_spend_monitored_ent_last_sum:
           description: Shows the sum of the last value of the amount of cloud spend monitored for Enterprise in the current month for all organizations.
           format: int64
@@ -22873,6 +23938,10 @@ components:
           description: Shows the sum of the last value of the amount of cloud spend monitored for Pro in the current month for all organizations.
           format: int64
           type: integer
+        ccm_twilio_spend_last_sum:
+          description: Shows the sum of the last value of Twilio cloud spend monitored in the current month for all organizations.
+          format: int64
+          type: integer
         ci_pipeline_indexed_spans_agg_sum:
           description: Shows the sum of all CI pipeline indexed spans over all hours in the current month for all organizations.
           format: int64
@@ -23915,6 +24984,158 @@ components:
           description: Information pertaining to a user disabled for a given organization.
           type: string
       type: object
+    UserJourneyFormulaCompute:
+      additionalProperties: false
+      description: Compute configuration for User Journey formula queries.
+      properties:
+        aggregation:
+          $ref: "#/components/schemas/FormulaAndFunctionEventAggregation"
+        interval:
+          description: Time bucket interval in milliseconds for time series queries.
+          example: 60000
+          format: double
+          type: number
+        metric:
+          $ref: "#/components/schemas/UserJourneyFormulaComputeMetric"
+        target:
+          $ref: "#/components/schemas/UserJourneySearchTarget"
+      required:
+        - aggregation
+      type: object
+    UserJourneyFormulaComputeMetric:
+      description: Metric for User Journey formula compute. `__dd.conversion` and `__dd.conversion_rate` accept `count` and `cardinality` as aggregations. `__dd.time_to_convert` accepts `avg`, `median`, `pc75`, `pc95`, `pc98`, `pc99`, `min`, and `max`.
+      enum:
+        - __dd.conversion
+        - __dd.conversion_rate
+        - __dd.time_to_convert
+      example: __dd.conversion_rate
+      type: string
+      x-enum-varnames:
+        - CONVERSION
+        - CONVERSION_RATE
+        - TIME_TO_CONVERT
+    UserJourneyFormulaGroupBy:
+      description: Group by configuration for User Journey formula queries.
+      properties:
+        facet:
+          description: Facet name to group by.
+          example: "@usr.email"
+          type: string
+        limit:
+          description: Maximum number of groups to return.
+          example: 10
+          format: int32
+          maximum: 10000
+          type: integer
+        should_exclude_missing:
+          description: Whether to exclude events missing the group-by facet.
+          type: boolean
+        sort:
+          $ref: "#/components/schemas/FormulaAndFunctionEventQueryGroupBySort"
+        target:
+          $ref: "#/components/schemas/UserJourneySearchTarget"
+      required:
+        - facet
+      type: object
+    UserJourneyJoinKeys:
+      description: Join keys for user journey queries.
+      properties:
+        primary:
+          description: Primary join key.
+          example: "@session.id"
+          type: string
+        secondary:
+          description: Secondary join keys.
+          items:
+            description: A secondary join key.
+            type: string
+          type: array
+      required:
+        - primary
+      type: object
+    UserJourneySearch:
+      additionalProperties: false
+      description: User journey search configuration.
+      properties:
+        expression:
+          description: Expression string.
+          example: "node_0 -> node_1"
+          type: string
+        filters:
+          $ref: "#/components/schemas/UserJourneySearchFilters"
+        join_keys:
+          $ref: "#/components/schemas/UserJourneyJoinKeys"
+        node_objects:
+          additionalProperties:
+            $ref: "#/components/schemas/ProductAnalyticsBaseQuery"
+          description: Node objects mapping.
+          type: object
+        step_aliases:
+          additionalProperties:
+            type: string
+          description: Step aliases mapping.
+          type: object
+      required:
+        - node_objects
+        - expression
+      type: object
+    UserJourneySearchFilters:
+      description: Filters for user journey search.
+      properties:
+        audience_filters:
+          $ref: "#/components/schemas/ProductAnalyticsAudienceFilters"
+        graph_filters:
+          description: Graph filters.
+          items:
+            $ref: "#/components/schemas/UserJourneySearchGraphFilter"
+            description: A graph filter for user journey search.
+          type: array
+        string_filter:
+          description: String filter.
+          example: "@session.type:user"
+          type: string
+      type: object
+    UserJourneySearchGraphFilter:
+      description: Graph filter for user journey search.
+      properties:
+        name:
+          description: Filter name.
+          example: "count"
+          type: string
+        operator:
+          description: Filter operator.
+          example: "gt"
+          type: string
+        target:
+          $ref: "#/components/schemas/UserJourneySearchTarget"
+        value:
+          description: Filter value.
+          example: 1
+          format: int64
+          type: integer
+      type: object
+    UserJourneySearchTarget:
+      description: Target for user journey search.
+      properties:
+        end:
+          description: End value.
+          example: "node_1"
+          type: string
+        start:
+          description: Start value.
+          example: "node_0"
+          type: string
+        type:
+          description: Target type.
+          example: "step"
+          type: string
+        value:
+          description: Target value.
+          example: "node_0"
+          type: string
+      required:
+        - type
+      type: object
     UserListResponse:
       description: Array of Datadog users for a given organization.
       properties:
@@ -24267,11 +25488,13 @@ components:
         - $ref: "#/components/schemas/BarChartWidgetDefinition"
         - $ref: "#/components/schemas/ChangeWidgetDefinition"
         - $ref: "#/components/schemas/CheckStatusWidgetDefinition"
+        - $ref: "#/components/schemas/CohortWidgetDefinition"
         - $ref: "#/components/schemas/DistributionWidgetDefinition"
         - $ref: "#/components/schemas/EventStreamWidgetDefinition"
         - $ref: "#/components/schemas/EventTimelineWidgetDefinition"
         - $ref: "#/components/schemas/FreeTextWidgetDefinition"
         - $ref: "#/components/schemas/FunnelWidgetDefinition"
+        - $ref: "#/components/schemas/ProductAnalyticsFunnelWidgetDefinition"
         - $ref: "#/components/schemas/GeomapWidgetDefinition"
         - $ref: "#/components/schemas/GroupWidgetDefinition"
         - $ref: "#/components/schemas/HeatMapWidgetDefinition"
@@ -24284,6 +25507,7 @@ components:
         - $ref: "#/components/schemas/NoteWidgetDefinition"
         - $ref: "#/components/schemas/PowerpackWidgetDefinition"
         - $ref: "#/components/schemas/QueryValueWidgetDefinition"
+        - $ref: "#/components/schemas/RetentionCurveWidgetDefinition"
         - $ref: "#/components/schemas/RunWorkflowWidgetDefinition"
         - $ref: "#/components/schemas/SLOListWidgetDefinition"
         - $ref: "#/components/schemas/SLOWidgetDefinition"
@@ -25289,6 +26513,7 @@ paths:
                 - ap2.datadoghq.com
                 - datadoghq.eu
                 - ddog-gov.com
+                - us2.ddog-gov.com
             subdomain:
               default: ip-ranges
               description: The subdomain where the API is deployed.
@@ -25340,6 +26565,10 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  name: example key
             schema:
               $ref: "#/components/schemas/ApiKey"
         required: true
@@ -25468,6 +26697,10 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  name: example key
             schema:
               $ref: "#/components/schemas/ApiKey"
         required: true
@@ -25543,6 +26776,10 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  name: example key
             schema:
               $ref: "#/components/schemas/ApplicationKey"
         required: true
@@ -25679,6 +26916,10 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  name: example key
             schema:
               $ref: "#/components/schemas/ApplicationKey"
         required: true
@@ -25736,6 +26977,15 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  - check: app.ok
+                    host_name: app.host1
+                    message: app is running
+                    status: 0
+                    tags:
+                      - "environment:test"
             schema:
               $ref: "#/components/schemas/ServiceChecks"
         description: Service Check request body.
@@ -25895,6 +27145,13 @@ paths:
         content:
           application/json:
             examples:
+              default:
+                value:
+                  data:
+                    - id: 123-abc-456
+                      type: dashboard
+                    - id: 789-def-101
+                      type: dashboard
               json-request-body:
                 value: {"data": [{"id": "123-abc-456", "type": "dashboard"}, {"id": "789-def-101", "type": "dashboard"}]}
             schema:
@@ -26014,6 +27271,13 @@ paths:
         content:
           application/json:
             examples:
+              default:
+                value:
+                  data:
+                    - id: 123-abc-456
+                      type: dashboard
+                    - id: 789-def-101
+                      type: dashboard
               json-request-body:
                 value: {"data": [{"id": "123-abc-456", "type": "dashboard"}, {"id": "789-def-101", "type": "dashboard"}]}
             schema:
@@ -26064,6 +27328,18 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  description: An example dashboard for monitoring infrastructure.
+                  layout_type: ordered
+                  title: Example Dashboard
+                  widgets:
+                    - definition:
+                        requests:
+                          - q: avg:system.cpu.user{*}
+                        title: CPU Usage
+                        type: timeseries
             schema:
               $ref: "#/components/schemas/Dashboard"
         description: Create a dashboard request body.
@@ -26141,6 +27417,10 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  name: My Dashboard List
             schema:
               $ref: "#/components/schemas/DashboardList"
         description: Create a dashboard list request body.
@@ -26285,6 +27565,10 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  name: My Dashboard List
             schema:
               $ref: "#/components/schemas/DashboardList"
         description: Update a dashboard list request body.
@@ -26338,6 +27622,13 @@ paths:
         content:
           application/json:
             examples:
+              default:
+                value:
+                  dashboard_id: 123-abc-456
+                  dashboard_type: custom_timeboard
+                  global_time:
+                    live_span: 1h
+                  share_type: open
               json-request-body:
                 value: {"dashboard_id": "123-abc-456", "dashboard_type": "custom_timeboard", "share_type": "open"}
             schema:
@@ -26499,6 +27790,21 @@ paths:
         content:
           application/json:
             examples:
+              default:
+                value:
+                  global_time:
+                    live_span: 1h
+                  selectable_template_vars:
+                    - default_value: "*"
+                      name: exampleVar
+                      prefix: test
+                      visible_tags:
+                        - selectableValue1
+                        - selectableValue2
+                  share_list:
+                    - test@datadoghq.com
+                    - test2@datadoghq.com
+                  share_type: invite
               json-request-body:
                 value: {"global_time": {"live_span": "1h"}, "selectable_template_vars": [{"default_value": "*", "name": "exampleVar", "prefix": "test", "visible_tags": ["selectableValue1", "selectableValue2"]}], "share_list": ["test@datadoghq.com", "test2@datadoghq.com"], "share_type": "invite"}
             schema:
@@ -26567,6 +27873,12 @@ paths:
         content:
           application/json:
             examples:
+              default:
+                value:
+                  data:
+                    attributes:
+                      email: test@datadoghq.com
+                    type: public_dashboard_invitation
               json-request-body:
                 value: {"data": {"attributes": {"email": "test@datadoghq.com"}, "type": "public_dashboard_invitation"}}
             schema:
@@ -26676,6 +27988,12 @@ paths:
         content:
           application/json:
             examples:
+              default:
+                value:
+                  data:
+                    - attributes:
+                        email: test@datadoghq.com
+                      type: public_dashboard_invitation
               json-request-body:
                 value: {"data": [{"attributes": {"email": "test@datadoghq.com"}, "type": "public_dashboard_invitation"}]}
             schema:
@@ -26822,6 +28140,18 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  description: An example dashboard for monitoring infrastructure.
+                  layout_type: ordered
+                  title: Example Dashboard
+                  widgets:
+                    - definition:
+                        requests:
+                          - q: avg:system.cpu.user{*}
+                        title: CPU Usage
+                        type: timeseries
             schema:
               $ref: "#/components/schemas/Dashboard"
         description: Update Dashboard request body.
@@ -26881,6 +28211,16 @@ paths:
         content:
           text/json:
             examples:
+              default:
+                value:
+                  series:
+                    - host: test.example.com
+                      metric: system.load.1
+                      points:
+                        - [1636629071, [1.0, 2.0]]
+                      tags:
+                        - "environment:test"
+                      type: distribution
               dynamic-points:
                 description: Post time-series data that can be graphed on Datadog’s dashboards.
                 externalValue: examples/metrics/distribution-points.json.sh
@@ -26985,6 +28325,17 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  end: 1412793983
+                  message: Scheduling downtime for a database maintenance window.
+                  monitor_tags:
+                    - "*"
+                  scope:
+                    - env:staging
+                  start: 1412792983
+                  timezone: America/New_York
             schema:
               $ref: "#/components/schemas/Downtime"
         description: Schedule a downtime request body.
@@ -27032,6 +28383,10 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  scope: host:myserver
             schema:
               $ref: "#/components/schemas/CancelDowntimesByScopeRequest"
         description: Scope to cancel downtimes for.
@@ -27185,6 +28540,17 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  end: 1412793983
+                  message: Updating downtime end time.
+                  monitor_tags:
+                    - "*"
+                  scope:
+                    - env:staging
+                  start: 1412792983
+                  timezone: America/New_York
             schema:
               $ref: "#/components/schemas/Downtime"
         description: Update a downtime request body.
@@ -27344,6 +28710,14 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  priority: normal
+                  tags:
+                    - environment:test
+                  text: Oh boy!
+                  title: Did you hear the news today?
             schema:
               $ref: "#/components/schemas/EventCreateRequest"
         description: Event request object
@@ -27526,6 +28900,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  end: 1579098130
+                  message: Muting this host for a test!
+                  override: false
             schema:
               $ref: "#/components/schemas/HostMuteSettings"
         description: Mute a host request body.
@@ -27741,6 +29121,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "123456789012"
+                  role_name: "DatadogAWSIntegrationRole"
             schema:
               $ref: "#/components/schemas/AWSAccountDeleteRequest"
         description: AWS request object
@@ -27842,6 +29227,24 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "123456789012"
+                  account_specific_namespace_rules:
+                    auto_scaling: false
+                    opswork: false
+                  cspm_resource_collection_enabled: true
+                  excluded_regions:
+                    - us-east-1
+                    - us-west-2
+                  extended_resource_collection_enabled: true
+                  filter_tags:
+                    - "$KEY:$VALUE"
+                  host_tags:
+                    - "$KEY:$VALUE"
+                  metrics_collection_enabled: false
+                  role_name: "DatadogAWSIntegrationRole"
             schema:
               $ref: "#/components/schemas/AWSAccount"
         description: AWS Request Object
@@ -27911,6 +29314,24 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "123456789012"
+                  account_specific_namespace_rules:
+                    auto_scaling: false
+                    opswork: false
+                  cspm_resource_collection_enabled: true
+                  excluded_regions:
+                    - us-east-1
+                    - us-west-2
+                  extended_resource_collection_enabled: true
+                  filter_tags:
+                    - "$KEY:$VALUE"
+                  host_tags:
+                    - "$KEY:$VALUE"
+                  metrics_collection_enabled: false
+                  role_name: "DatadogAWSIntegrationRole"
             schema:
               $ref: "#/components/schemas/AWSAccount"
         description: AWS request object
@@ -27988,6 +29409,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "123456789012"
+                  event_generator_name: app-alerts-zyxw3210
+                  region: us-east-1
             schema:
               $ref: "#/components/schemas/AWSEventBridgeDeleteRequest"
         description: Delete the Amazon EventBridge source with the given name, region, and associated AWS account.
@@ -28060,6 +29487,13 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "123456789012"
+                  create_event_bus: true
+                  event_generator_name: app-alerts
+                  region: us-east-1
             schema:
               $ref: "#/components/schemas/AWSEventBridgeCreateRequest"
         description: Create an Amazon EventBridge source for an AWS account with a given name and region.
@@ -28101,6 +29535,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "FAKEAC0FAKEAC2FAKEAC"
+                  namespace: elb
             schema:
               $ref: "#/components/schemas/AWSTagFilterDeleteRequest"
         description: Delete a tag filtering entry for a given AWS account and `dd-aws` namespace.
@@ -28181,6 +29620,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "123456789012"
+                  namespace: elb
+                  tag_filter_str: "prod*"
             schema:
               $ref: "#/components/schemas/AWSTagFilterCreateRequest"
         description: |-
@@ -28225,6 +29670,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "123456789012"
+                  role_name: "DatadogAWSIntegrationRole"
             schema:
               $ref: "#/components/schemas/AWSAccount"
         description: |-
@@ -28269,6 +29719,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "1234567"
+                  lambda_arn: "arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest"
             schema:
               $ref: "#/components/schemas/AWSAccountAndLambdaRequest"
         description: Delete AWS Lambda ARN request body.
@@ -28345,6 +29800,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "1234567"
+                  lambda_arn: "arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest"
             schema:
               $ref: "#/components/schemas/AWSAccountAndLambdaRequest"
         description: AWS Log Lambda Async request body.
@@ -28393,6 +29853,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "1234567"
+                  lambda_arn: "arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest"
             schema:
               $ref: "#/components/schemas/AWSAccountAndLambdaRequest"
         description: Check AWS Log Lambda Async request body.
@@ -28465,6 +29930,17 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "1234567"
+                  services:
+                    - s3
+                    - elb
+                    - elbv2
+                    - cloudfront
+                    - redshift
+                    - lambda
             schema:
               $ref: "#/components/schemas/AWSLogsServicesRequest"
         description: Enable AWS Log Services request body.
@@ -28515,6 +29991,17 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  account_id: "1234567"
+                  services:
+                    - s3
+                    - elb
+                    - elbv2
+                    - cloudfront
+                    - redshift
+                    - lambda
             schema:
               $ref: "#/components/schemas/AWSLogsServicesRequest"
         description: Check AWS Logs Async Services request body.
@@ -28556,6 +30043,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  client_id: "testc7f6-1234-5678-9101-3fcbf464test"
+                  tenant_name: "testc44-1234-5678-9101-cc00736ftest"
             schema:
               $ref: "#/components/schemas/AzureAccount"
         description: Delete a given Datadog-Azure integration request body.
@@ -28635,6 +30127,20 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  app_service_plan_filters: "key:value,filter:example"
+                  automute: true
+                  client_id: "testc7f6-1234-5678-9101-3fcbf464test"
+                  client_secret: "TestingRh2nx664kUy5dIApvM54T4AtO"
+                  container_app_filters: "key:value,filter:example"
+                  cspm_enabled: true
+                  custom_metrics_enabled: true
+                  host_filters: "key:value,filter:example"
+                  metrics_enabled: true
+                  resource_collection_enabled: true
+                  tenant_name: "testc44-1234-5678-9101-cc00736ftest"
             schema:
               $ref: "#/components/schemas/AzureAccount"
         description: Create a Datadog-Azure integration for your Datadog account request body.
@@ -28678,6 +30184,19 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  automute: true
+                  client_id: "testc7f6-1234-5678-9101-3fcbf464test"
+                  client_secret: "TestingRh2nx664kUy5dIApvM54T4AtO"
+                  cspm_enabled: true
+                  host_filters: "key:value,filter:example"
+                  metrics_enabled: true
+                  new_client_id: "new1c7f6-1234-5678-9101-3fcbf464test"
+                  new_tenant_name: "new1c44-1234-5678-9101-cc00736ftest"
+                  resource_collection_enabled: true
+                  tenant_name: "testc44-1234-5678-9101-cc00736ftest"
             schema:
               $ref: "#/components/schemas/AzureAccount"
         description: Update a Datadog-Azure integration request body.
@@ -28720,6 +30239,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  client_id: "testc7f6-1234-5678-9101-3fcbf464test"
+                  host_filters: "key:value,filter:example"
+                  tenant_name: "testc44-1234-5678-9101-cc00736ftest"
             schema:
               $ref: "#/components/schemas/AzureAccount"
         description: Update a Datadog-Azure integration's host filters request body.
@@ -28763,6 +30288,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  client_email: "test@sandbox.iam.gserviceaccount.com"
+                  client_id: "123456712345671234567"
+                  project_id: "datadog-apitest"
             schema:
               $ref: "#/components/schemas/GCPAccount"
         description: Delete a given Datadog-GCP integration.
@@ -28838,6 +30369,22 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  auth_provider_x509_cert_url: "https://www.googleapis.com/oauth2/v1/certs"
+                  auth_uri: "https://accounts.google.com/o/oauth2/auth"
+                  client_email: "test@sandbox.iam.gserviceaccount.com"
+                  client_id: "123456712345671234567"
+                  client_x509_cert_url: "https://www.googleapis.com/robot/v1/metadata/x509/$CLIENT_EMAIL"
+                  host_filters: "$KEY1:$VALUE1,$KEY2:$VALUE2"
+                  is_cspm_enabled: true
+                  private_key: "private_key"
+                  private_key_id: "123456789abcdefghi123456789abcdefghijklm"
+                  project_id: "datadog-apitest"
+                  resource_collection_enabled: true
+                  token_uri: "https://accounts.google.com/o/oauth2/token"
+                  type: "service_account"
             schema:
               $ref: "#/components/schemas/GCPAccount"
         description: Create a Datadog-GCP integration.
@@ -28883,6 +30430,15 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  client_email: "test@sandbox.iam.gserviceaccount.com"
+                  client_id: "123456712345671234567"
+                  host_filters: "$KEY1:$VALUE1,$KEY2:$VALUE2"
+                  is_cspm_enabled: true
+                  project_id: "datadog-apitest"
+                  resource_collection_enabled: true
             schema:
               $ref: "#/components/schemas/GCPAccount"
         description: Update a Datadog-GCP integration.
@@ -28924,6 +30480,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  service_key: "your-pagerduty-service-key"
+                  service_name: "my-pagerduty-service"
             schema:
               $ref: "#/components/schemas/PagerDutyService"
         description: Create a new service object request body.
@@ -29044,6 +30605,10 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  service_key: "updated-pagerduty-service-key"
             schema:
               $ref: "#/components/schemas/PagerDutyServiceKey"
         description: Update an existing service object request body.
@@ -29127,6 +30692,16 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  display:
+                    message: true
+                    mute_buttons: false
+                    notified: true
+                    snapshot: true
+                    tags: true
+                  name: "#general"
             schema:
               $ref: "#/components/schemas/SlackIntegrationChannel"
         description: Payload describing Slack channel to be created
@@ -29252,6 +30827,16 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  display:
+                    message: true
+                    mute_buttons: false
+                    notified: true
+                    snapshot: true
+                    tags: true
+                  name: "#general"
             schema:
               $ref: "#/components/schemas/SlackIntegrationChannel"
         description: Payload describing fields and values to be updated.
@@ -29298,6 +30883,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  is_secret: true
+                  name: CUSTOM_VARIABLE_NAME
+                  value: CUSTOM_VARIABLE_VALUE
             schema:
               $ref: "#/components/schemas/WebhooksIntegrationCustomVariable"
         description: Define a custom variable request body.
@@ -29427,6 +31018,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  is_secret: true
+                  name: CUSTOM_VARIABLE_NAME
+                  value: CUSTOM_VARIABLE_VALUE
             schema:
               $ref: "#/components/schemas/WebhooksIntegrationCustomVariableUpdateRequest"
         description: Update an existing custom variable request body.
@@ -29473,6 +31070,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  encode_as: json
+                  name: WEBHOOK_NAME
+                  url: https://example.com/webhook
             schema:
               $ref: "#/components/schemas/WebhooksIntegration"
         description: Create a webhooks integration request body.
@@ -29603,6 +31206,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  encode_as: json
+                  name: WEBHOOK_NAME
+                  url: https://example.com/webhook
             schema:
               $ref: "#/components/schemas/WebhooksIntegrationUpdateRequest"
         description: Update an existing Datadog-Webhooks integration.
@@ -29660,6 +31269,16 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  index: "retention-3,retention-15"
+                  limit: 25
+                  query: "service:web* AND @http.status_code:[200 TO 299]"
+                  sort: desc
+                  time:
+                    from: "2020-02-02T02:02:02.202Z"
+                    to: "2020-02-20T02:02:02.202Z"
             schema:
               $ref: "#/components/schemas/LogsListRequest"
         description: Logs filter
@@ -29732,6 +31351,13 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  index_names:
+                    - main
+                    - payments
+                    - web
             schema:
               $ref: "#/components/schemas/LogsIndexesOrder"
         description: Object containing the new ordered list of index names
@@ -29800,6 +31426,21 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  daily_limit: 300000000
+                  daily_limit_warning_threshold_percentage: 70
+                  exclusion_filters:
+                    - filter:
+                        query: "*"
+                        sample_rate: 1.0
+                      is_enabled: true
+                      name: payment
+                  filter:
+                    query: source:python
+                  name: main
+                  num_retention_days: 15
             schema:
               $ref: "#/components/schemas/LogsIndex"
         description: Object containing the new index.
@@ -29933,6 +31574,21 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  daily_limit: 300000000
+                  daily_limit_warning_threshold_percentage: 70
+                  disable_daily_limit: false
+                  exclusion_filters:
+                    - filter:
+                        query: "*"
+                        sample_rate: 1.0
+                      is_enabled: true
+                      name: payment
+                  filter:
+                    query: source:python
+                  num_retention_days: 15
             schema:
               $ref: "#/components/schemas/LogsIndexUpdateRequest"
         description: Object containing the new `LogsIndexUpdateRequest`.
@@ -30005,6 +31661,13 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  pipeline_ids:
+                    - tags
+                    - org_ids
+                    - products
             schema:
               $ref: "#/components/schemas/LogsPipelinesOrder"
         description: Object containing the new ordered list of pipeline IDs.
@@ -30078,6 +31741,14 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  filter:
+                    query: source:python
+                  is_enabled: true
+                  name: My Pipeline
+                  processors: []
             schema:
               $ref: "#/components/schemas/LogsPipeline"
         description: Definition of the new pipeline.
@@ -30205,6 +31876,14 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  filter:
+                    query: source:python
+                  is_enabled: true
+                  name: My Pipeline
+                  processors: []
             schema:
               $ref: "#/components/schemas/LogsPipeline"
         description: New definition of the pipeline.
@@ -30358,6 +32037,13 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  description: Number of requests received.
+                  per_unit: second
+                  type: count
+                  unit: byte
             schema:
               $ref: "#/components/schemas/MetricMetadata"
         description: New metadata.
@@ -30744,15 +32430,18 @@ paths:
         content:
           application/json:
             examples:
-              json-request-body:
+              default:
                 value:
                   message: "You may need to add web hosts if this is consistently high."
                   name: "Bytes received on host0"
                   options:
                     no_data_timeframe: 20
                     notify_no_data: true
+                  priority: 3
                   query: "avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100"
-                  tags: ["app:webserver", "frontend"]
+                  tags:
+                    - "app:webserver"
+                    - "frontend"
                   type: "query alert"
             schema:
               $ref: "#/components/schemas/Monitor"
@@ -31017,6 +32706,19 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  message: "You may need to add web hosts if this is consistently high."
+                  name: "My monitor"
+                  options:
+                    no_data_timeframe: 20
+                    notify_no_data: true
+                  query: "avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100"
+                  tags:
+                    - "app:webserver"
+                    - "frontend"
+                  type: "query alert"
             schema:
               $ref: "#/components/schemas/Monitor"
         description: Monitor request object
@@ -31205,6 +32907,20 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  message: "Updated notification message for this monitor."
+                  name: "Updated monitor name"
+                  options:
+                    no_data_timeframe: 20
+                    notify_no_data: true
+                  priority: 3
+                  query: "avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100"
+                  tags:
+                    - "app:webserver"
+                    - "frontend"
+                  type: "query alert"
             schema:
               $ref: "#/components/schemas/MonitorUpdateRequest"
         description: Edit a monitor request body.
@@ -31321,6 +33037,19 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  message: "You may need to add web hosts if this is consistently high."
+                  name: "My monitor"
+                  options:
+                    no_data_timeframe: 20
+                    notify_no_data: true
+                  query: "avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100"
+                  tags:
+                    - "app:webserver"
+                    - "frontend"
+                  type: "query alert"
             schema:
               $ref: "#/components/schemas/Monitor"
         description: Monitor request object
@@ -31607,6 +33336,39 @@ paths:
         content:
           application/json:
             examples:
+              default:
+                value:
+                  data:
+                    attributes:
+                      cells:
+                        - attributes:
+                            definition:
+                              text: "## Some test markdown\n\nWith some example content."
+                              type: markdown
+                          type: notebook_cells
+                        - attributes:
+                            definition:
+                              requests:
+                                - display_type: line
+                                  q: "avg:system.load.1{*}"
+                                  style:
+                                    line_type: solid
+                                    line_width: normal
+                                    palette: dog_classic
+                              show_legend: true
+                              type: timeseries
+                              yaxis:
+                                scale: linear
+                            graph_size: m
+                            split_by:
+                              keys: []
+                              tags: []
+                            time:
+                          type: notebook_cells
+                      name: "Example Notebook"
+                      time:
+                        live_span: 1h
+                    type: notebooks
               json-request-body:
                 value: {"data": {"attributes": {"cells": [{"attributes": {"definition": {"text": "## Some test markdown\n\nWith some example content.", "type": "markdown"}}, "type": "notebook_cells"}, {"attributes": {"definition": {"requests": [{"display_type": "line", "q": "avg:system.load.1{*}", "style": {"line_type": "solid", "line_width": "normal", "palette": "dog_classic"}}], "show_legend": true, "type": "timeseries", "yaxis": {"scale": "linear"}}, "graph_size": "m", "split_by": {"keys": [], "tags": []}, "time": null}, "type": "notebook_cells"}], "name": "Example Notebook", "time": {"live_span": "1h"}}, "type": "notebooks"}}
             schema:
@@ -31744,6 +33506,40 @@ paths:
         content:
           application/json:
             examples:
+              default:
+                value:
+                  data:
+                    attributes:
+                      cells:
+                        - attributes:
+                            definition:
+                              text: "## Some updated test markdown\n\nWith some example content."
+                              type: markdown
+                          type: notebook_cells
+                        - attributes:
+                            definition:
+                              requests:
+                                - display_type: bars
+                                  q: "avg:system.load.1{*}"
+                                  style:
+                                    line_type: solid
+                                    line_width: normal
+                                    palette: warm
+                              show_legend: true
+                              type: timeseries
+                              yaxis:
+                                scale: linear
+                            graph_size: m
+                            split_by:
+                              keys: []
+                              tags: []
+                            time:
+                          id: "abcd1234"
+                          type: notebook_cells
+                      name: "Example Notebook"
+                      time:
+                        live_span: 1h
+                    type: notebooks
               json-request-body:
                 value: {"data": {"attributes": {"cells": [{"attributes": {"definition": {"text": "## Some updated test markdown\n\nWith some example content.", "type": "markdown"}}, "type": "notebook_cells"}, {"attributes": {"definition": {"requests": [{"display_type": "bars", "q": "avg:system.load.1{*}", "style": {"line_type": "solid", "line_width": "normal", "palette": "warm"}}], "show_legend": true, "type": "timeseries", "yaxis": {"scale": "linear"}}, "graph_size": "m", "split_by": {"keys": [], "tags": []}, "time": null}, "id": "abcd1234", "type": "notebook_cells"}], "name": "Example Notebook", "time": {"live_span": "1h"}}, "type": "notebooks"}}
             schema:
@@ -31833,6 +33629,14 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  billing:
+                    type: parent_billing
+                  name: "New child org"
+                  subscription:
+                    type: pro
             schema:
               $ref: "#/components/schemas/OrganizationCreateBody"
         description: Organization object that needs to be created
@@ -31916,6 +33720,19 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  billing:
+                    type: parent_billing
+                  name: "New child org"
+                  settings:
+                    saml:
+                      enabled: false
+                    saml_idp_initiated_login:
+                      enabled: false
+                    saml_strict_mode:
+                      enabled: false
             schema:
               $ref: "#/components/schemas/Organization"
         required: true
@@ -32001,6 +33818,10 @@ paths:
       requestBody:
         content:
           multipart/form-data:
+            examples:
+              default:
+                value:
+                  idp_file: "@/path/to/idp_metadata.xml"
             schema:
               $ref: "#/components/schemas/IdpFormData"
         required: true
@@ -32151,6 +33972,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  incident_id: 2066
+                  version: 0
             schema:
               $ref: "#/components/schemas/AddSignalToIncidentRequest"
         description: Attributes describing the signal update.
@@ -32200,6 +34026,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  assignee: "773b045d-ccf8-4808-bd3b-955ef6a8c940"
+                  version: 0
             schema:
               $ref: "#/components/schemas/SignalAssigneeUpdateRequest"
         description: Attributes describing the signal update.
@@ -32249,6 +34080,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  archiveReason: none
+                  state: open
+                  version: 0
             schema:
               $ref: "#/components/schemas/SignalStateUpdateRequest"
         description: Attributes describing the signal update.
@@ -32313,6 +34150,16 @@ paths:
         content:
           text/json:
             examples:
+              default:
+                value:
+                  series:
+                    - host: test.example.com
+                      metric: system.load.1
+                      points:
+                        - [1636629071, 0.7]
+                      tags:
+                        - "environment:test"
+                      type: gauge
               dynamic-points:
                 description: Post time-series data that can be graphed on Datadog’s dashboards.
                 externalValue: examples/metrics/dynamic-points.json.sh
@@ -32462,6 +34309,24 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  description: "Track the availability of our custom metric."
+                  name: "Custom Metric SLO"
+                  query:
+                    denominator: "sum:my.custom.metric{*}.as_count()"
+                    numerator: "sum:my.custom.metric{type:good}.as_count()"
+                  tags:
+                    - "env:prod"
+                    - "app:core"
+                  thresholds:
+                    - target: 95
+                      timeframe: 7d
+                    - target: 95
+                      timeframe: 30d
+                      warning: 97
+                  type: metric
             schema:
               $ref: "#/components/schemas/ServiceLevelObjectiveRequest"
         description: Service level objective request object.
@@ -32512,6 +34377,15 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  id1:
+                    - "7d"
+                    - "30d"
+                  id2:
+                    - "7d"
+                    - "30d"
             schema:
               $ref: "#/components/schemas/SLOBulkDelete"
         description: Delete multiple service level objective objects request body.
@@ -32665,6 +34539,18 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  data:
+                    attributes:
+                      category: "Scheduled Maintenance"
+                      description: "Planned maintenance window for database upgrade."
+                      end: 1600003600
+                      slo_id: sloId
+                      start: 1600000000
+                      timezone: UTC
+                    type: correction
             schema:
               $ref: "#/components/schemas/SLOCorrectionCreateRequest"
         description: Create an SLO Correction
@@ -32789,6 +34675,17 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  data:
+                    attributes:
+                      category: "Scheduled Maintenance"
+                      description: "Updated correction for maintenance window."
+                      end: 1600003600
+                      start: 1600000000
+                      timezone: UTC
+                    type: correction
             schema:
               $ref: "#/components/schemas/SLOCorrectionUpdateRequest"
         description: The edited SLO correction object.
@@ -33014,6 +34911,24 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  description: "Updated description for the SLO."
+                  name: "Custom Metric SLO"
+                  query:
+                    denominator: "sum:my.custom.metric{*}.as_count()"
+                    numerator: "sum:my.custom.metric{type:good}.as_count()"
+                  tags:
+                    - "env:prod"
+                    - "app:core"
+                  thresholds:
+                    - target: 95
+                      timeframe: 7d
+                    - target: 95
+                      timeframe: 30d
+                      warning: 97
+                  type: metric
             schema:
               $ref: "#/components/schemas/ServiceLevelObjective"
         description: The edited service level objective request object.
@@ -33271,6 +35186,13 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  description: Description of private location
+                  name: New private location
+                  tags:
+                    - "team:front"
             schema:
               $ref: "#/components/schemas/SyntheticsPrivateLocation"
         description: Details of the private location to create.
@@ -33397,6 +35319,13 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  description: Description of private location
+                  name: New private location
+                  tags:
+                    - "team:front"
             schema:
               $ref: "#/components/schemas/SyntheticsPrivateLocation"
         description: Details of the private location to be updated.
@@ -33638,6 +35567,29 @@ paths:
                   tags:
                     - "env:prod"
                   type: api
+              default:
+                value:
+                  config:
+                    assertions:
+                      - operator: is
+                        target: 200
+                        type: statusCode
+                    request:
+                      method: GET
+                      url: "https://example.com"
+                  locations:
+                    - "aws:eu-west-3"
+                  message: Notification message
+                  name: Example API test
+                  options:
+                    min_failure_duration: 0
+                    min_location_failed: 1
+                    tick_every: 60
+                  status: live
+                  subtype: http
+                  tags:
+                    - "env:production"
+                  type: api
             schema:
               $ref: "#/components/schemas/SyntheticsAPITest"
         description: Details of the test to create.
@@ -33745,6 +35697,30 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  config:
+                    assertions:
+                      - operator: is
+                        target: 200
+                        type: statusCode
+                    request:
+                      method: GET
+                      url: "https://example.com"
+                  locations:
+                    - "aws:eu-west-3"
+                  message: Notification message
+                  name: Example API test
+                  options:
+                    min_failure_duration: 0
+                    min_location_failed: 1
+                    tick_every: 60
+                  status: live
+                  subtype: http
+                  tags:
+                    - "env:production"
+                  type: api
             schema:
               $ref: "#/components/schemas/SyntheticsAPITest"
         description: New test details to be saved.
@@ -33801,6 +35777,32 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  config:
+                    assertions: []
+                    request:
+                      method: GET
+                      url: "https://example.com"
+                  locations:
+                    - "aws:eu-west-3"
+                  message: ""
+                  name: Example browser test
+                  options:
+                    device_ids:
+                      - chrome.laptop_large
+                    tick_every: 3600
+                  status: live
+                  steps:
+                    - name: Check current URL
+                      params:
+                        check: contains
+                        value: example
+                      type: assertCurrentUrl
+                  tags:
+                    - "env:production"
+                  type: browser
             schema:
               $ref: "#/components/schemas/SyntheticsBrowserTest"
         description: Details of the test to create.
@@ -33908,6 +35910,32 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  config:
+                    assertions: []
+                    request:
+                      method: GET
+                      url: "https://example.com"
+                  locations:
+                    - "aws:eu-west-3"
+                  message: ""
+                  name: Example browser test
+                  options:
+                    device_ids:
+                      - chrome.laptop_large
+                    tick_every: 3600
+                  status: live
+                  steps:
+                    - name: Check current URL
+                      params:
+                        check: contains
+                        value: example
+                      type: assertCurrentUrl
+                  tags:
+                    - "env:production"
+                  type: browser
             schema:
               $ref: "#/components/schemas/SyntheticsBrowserTest"
         description: New test details to be saved.
@@ -34090,6 +36118,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  public_ids:
+                    - "abc-def-123"
             schema:
               $ref: "#/components/schemas/SyntheticsDeleteTestsPayload"
         description: Public ID list of the Synthetic tests to be deleted.
@@ -34146,6 +36179,22 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  config:
+                    variables: []
+                  device_ids:
+                    - "synthetics:mobile:device:apple_iphone_14_ios_16"
+                  message: Notification message
+                  name: Example mobile test
+                  options:
+                    min_failure_duration: 0
+                    min_location_failed: 1
+                    tick_every: 3600
+                  tags:
+                    - "env:production"
+                  type: mobile
             schema:
               $ref: "#/components/schemas/SyntheticsMobileTest"
         description: Details of the test to create.
@@ -34253,6 +36302,22 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  config:
+                    variables: []
+                  device_ids:
+                    - "synthetics:mobile:device:apple_iphone_14_ios_16"
+                  message: Notification message
+                  name: Example mobile test
+                  options:
+                    min_failure_duration: 0
+                    min_location_failed: 1
+                    tick_every: 3600
+                  tags:
+                    - "env:production"
+                  type: mobile
             schema:
               $ref: "#/components/schemas/SyntheticsMobileTest"
         description: New test details to be saved.
@@ -34389,6 +36454,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  tests:
+                    - public_id: aaa-aaa-aaa
             schema:
               $ref: "#/components/schemas/SyntheticsTriggerBody"
         description: The identifiers of the tests to trigger.
@@ -34428,6 +36498,11 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  tests:
+                    - public_id: aaa-aaa-aaa
             schema:
               $ref: "#/components/schemas/SyntheticsCITestBody"
         description: Details of the test to trigger.
@@ -34467,6 +36542,13 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  from_ts: 1726041488
+                  public_ids:
+                    - "abc-def-123"
+                  to_ts: 1726127888
             schema:
               $ref: "#/components/schemas/SyntheticsFetchUptimesPayload"
         description: Public ID list of the Synthetic tests and timeframe.
@@ -34567,6 +36649,15 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  data:
+                    - op: replace
+                      path: /name
+                      value: New test name
+                    - op: remove
+                      path: /config/assertions/0
             schema:
               $ref: "#/components/schemas/SyntheticsPatchTestBody"
         description: "[JSON Patch](https://jsonpatch.com/) compliant list of operations"
@@ -34752,6 +36843,10 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  new_status: live
             schema:
               $ref: "#/components/schemas/SyntheticsUpdateTestPauseStatusPayload"
         description: Status to set the given Synthetic test to.
@@ -34838,6 +36933,17 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  description: Example description
+                  name: MY_VARIABLE
+                  tags:
+                    - "team:front"
+                    - "test:workflow-1"
+                  value:
+                    secure: false
+                    value: variable-value
             schema:
               $ref: "#/components/schemas/SyntheticsGlobalVariableRequest"
         description: Details of the global variable to create.
@@ -34980,6 +37086,17 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  description: Example description
+                  name: MY_VARIABLE
+                  tags:
+                    - "team:front"
+                    - "test:workflow-1"
+                  value:
+                    secure: false
+                    value: variable-value
             schema:
               $ref: "#/components/schemas/SyntheticsGlobalVariableRequest"
         description: Details of the global variable to update.
@@ -35163,6 +37280,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  host: test.host
+                  tags:
+                    - "environment:production"
             schema:
               $ref: "#/components/schemas/HostTags"
         description: Update host tags request body.
@@ -35214,6 +37337,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  host: test.host
+                  tags:
+                    - "environment:production"
             schema:
               $ref: "#/components/schemas/HostTags"
         description: Add tags to host
@@ -37406,6 +39535,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  email: test@datadoghq.com
+                  handle: test@datadoghq.com
+                  name: test user
             schema:
               $ref: "#/components/schemas/User"
         description: User object that needs to be created.
@@ -37543,6 +39678,12 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              default:
+                value:
+                  disabled: false
+                  email: test@datadoghq.com
+                  name: test user
             schema:
               $ref: "#/components/schemas/User"
         description: Description of the update.
@@ -37647,6 +39788,13 @@ paths:
         content:
           application/json:
             examples:
+              default:
+                value:
+                  - ddsource: nginx
+                    ddtags: "env:staging,version:5.1"
+                    hostname: i-012345678
+                    message: "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World"
+                    service: payment
               multi-json-messages:
                 description: Pass multiple log objects at once.
                 summary: Multi JSON Messages
@@ -37657,6 +39805,13 @@ paths:
               $ref: "#/components/schemas/HTTPLog"
           application/json;simple:
             examples:
+              default:
+                value:
+                  ddsource: nginx
+                  ddtags: "env:staging,version:5.1"
+                  hostname: i-012345678
+                  message: "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World"
+                  service: payment
               simple-json-message:
                 description: Log attributes can be passed as `key:value` pairs in valid JSON messages.
                 summary: Simple JSON Message
@@ -37669,6 +39824,8 @@ paths:
               $ref: "#/components/schemas/HTTPLogItem"
           application/logplex-1:
             examples:
+              default:
+                value: "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World"
               multi-raw-message:
                 description: Submit log messages.
                 summary: Multi Logplex Messages
@@ -37683,6 +39840,8 @@ paths:
               type: string
           text/plain:
             examples:
+              default:
+                value: "2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World"
               multi-raw-message:
                 description: Submit log string.
                 summary: Multi Raw Messages
@@ -37729,6 +39888,7 @@ paths:
                 - ap2.datadoghq.com
                 - datadoghq.eu
                 - ddog-gov.com
+                - us2.ddog-gov.com
             subdomain:
               default: http-intake.logs
               description: The subdomain where the API is deployed.
@@ -37769,6 +39929,7 @@ servers:
           - ap2.datadoghq.com
           - datadoghq.eu
           - ddog-gov.com
+          - us2.ddog-gov.com
       subdomain:
         default: api
         description: The subdomain where the API is deployed.