Add Point Plot widget to dashboard API spec (#3274)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v1/openapi.yaml

@@ -1828,6 +1828,38 @@ components:
       x-enum-varnames:
         - CUSTOM_TIMEBOARD
         - CUSTOM_SCREENBOARD
+    DataProjectionQuery:
+      description: Query configuration for a data projection request.
+      properties:
+        data_source:
+          description: Data source for the query.
+          example: logs
+          type: string
+        indexes:
+          description: List of indexes to query.
+          items:
+            description: Index name.
+            type: string
+          type: array
+        query_string:
+          description: The query string to filter events.
+          example: "service:web-store"
+          type: string
+        storage:
+          description: Storage location for the query.
+          type: string
+      required:
+        - query_string
+        - data_source
+      type: object
+    DataProjectionRequestType:
+      description: Type of a data projection request.
+      enum:
+        - data_projection
+      example: data_projection
+      type: string
+      x-enum-varnames:
+        - DATA_PROJECTION
     DeleteSharedDashboardResponse:
       description: Response containing token of deleted shared dashboard.
       properties:
@@ -11343,6 +11375,150 @@ components:
       maxItems: 2
       minItems: 2
       type: array
+    PointPlotDimension:
+      description: Dimension of the point plot.
+      enum:
+        - group
+        - time
+        - y
+        - radius
+      example: y
+      type: string
+      x-enum-varnames:
+        - GROUP
+        - TIME
+        - Y
+        - RADIUS
+    PointPlotProjection:
+      description: Projection configuration for the point plot widget.
+      properties:
+        dimensions:
+          description: List of dimension mappings for the projection.
+          items:
+            $ref: "#/components/schemas/PointPlotProjectionDimension"
+          type: array
+        extra_columns:
+          description: Additional columns to include in the projection.
+          items:
+            description: Column name.
+            type: string
+          type: array
+        type:
+          $ref: "#/components/schemas/PointPlotProjectionType"
+      required:
+        - type
+        - dimensions
+      type: object
+    PointPlotProjectionDimension:
+      description: Dimension mapping for the point plot projection.
+      properties:
+        alias:
+          description: Alias for the column.
+          type: string
+        column:
+          description: Source column name from the dataset.
+          example: duration
+          type: string
+        dimension:
+          $ref: "#/components/schemas/PointPlotDimension"
+      required:
+        - column
+        - dimension
+      type: object
+    PointPlotProjectionType:
+      description: Type of the projection.
+      enum:
+        - point_plot
+      example: point_plot
+      type: string
+      x-enum-varnames:
+        - POINT_PLOT
+    PointPlotWidgetDefinition:
+      description: The point plot displays individual data points over time.
+      properties:
+        custom_links:
+          description: List of custom links.
+          items:
+            $ref: "#/components/schemas/WidgetCustomLink"
+          type: array
+        description:
+          description: The description of the widget.
+          type: string
+        legend:
+          $ref: "#/components/schemas/PointPlotWidgetLegend"
+        markers:
+          description: List of markers for the widget.
+          items:
+            $ref: "#/components/schemas/WidgetMarker"
+          type: array
+        requests:
+          description: List of request configurations for the widget.
+          items:
+            $ref: "#/components/schemas/PointPlotWidgetRequest"
+          type: array
+        time:
+          $ref: "#/components/schemas/WidgetTime"
+        title:
+          description: Title of the widget.
+          type: string
+        title_align:
+          $ref: "#/components/schemas/WidgetTextAlign"
+        title_size:
+          description: Size of the title.
+          type: string
+        type:
+          $ref: "#/components/schemas/PointPlotWidgetDefinitionType"
+        yaxis:
+          $ref: "#/components/schemas/WidgetAxis"
+      required:
+        - type
+        - requests
+      type: object
+    PointPlotWidgetDefinitionType:
+      default: point_plot
+      description: Type of the point plot widget.
+      enum:
+        - point_plot
+      example: point_plot
+      type: string
+      x-enum-varnames:
+        - POINT_PLOT
+    PointPlotWidgetLegend:
+      description: Legend configuration for the point plot widget.
+      properties:
+        type:
+          $ref: "#/components/schemas/PointPlotWidgetLegendType"
+      required:
+        - type
+      type: object
+    PointPlotWidgetLegendType:
+      description: Type of legend to show for the point plot widget.
+      enum:
+        - automatic
+        - none
+      example: automatic
+      type: string
+      x-enum-varnames:
+        - AUTOMATIC
+        - NONE
+    PointPlotWidgetRequest:
+      description: Request configuration for the point plot widget.
+      properties:
+        limit:
+          description: Maximum number of data points to return.
+          format: int64
+          type: integer
+        projection:
+          $ref: "#/components/schemas/PointPlotProjection"
+        query:
+          $ref: "#/components/schemas/DataProjectionQuery"
+        request_type:
+          $ref: "#/components/schemas/DataProjectionRequestType"
+      required:
+        - request_type
+        - query
+        - projection
+      type: object
     PowerpackTemplateVariableContents:
       description: Powerpack template variable contents.
       properties:
@@ -25663,6 +25839,7 @@ components:
         - $ref: "#/components/schemas/MonitorSummaryWidgetDefinition"
         - $ref: "#/components/schemas/NoteWidgetDefinition"
         - $ref: "#/components/schemas/PowerpackWidgetDefinition"
+        - $ref: "#/components/schemas/PointPlotWidgetDefinition"
         - $ref: "#/components/schemas/QueryValueWidgetDefinition"
         - $ref: "#/components/schemas/RetentionCurveWidgetDefinition"
         - $ref: "#/components/schemas/RunWorkflowWidgetDefinition"

cassettes/features/v1/dashboards/Create-a-new-dashboard-with-point-plot-widget.frozen

@@ -0,0 +1 @@
+2026-04-30T15:58:43.378Z

cassettes/features/v1/dashboards/Create-a-new-dashboard-with-point-plot-widget.yml

@@ -0,0 +1,42 @@
+# Create a new dashboard with point_plot widget
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V1::DashboardsAPI.new
+
+body = DatadogAPIClient::V1::Dashboard.new({
+  title: "Example-Dashboard",
+  layout_type: DatadogAPIClient::V1::DashboardLayoutType::ORDERED,
+  widgets: [
+    DatadogAPIClient::V1::Widget.new({
+      definition: DatadogAPIClient::V1::PointPlotWidgetDefinition.new({
+        title: "",
+        title_size: "16",
+        title_align: DatadogAPIClient::V1::WidgetTextAlign::LEFT,
+        type: DatadogAPIClient::V1::PointPlotWidgetDefinitionType::POINT_PLOT,
+        requests: [
+          DatadogAPIClient::V1::PointPlotWidgetRequest.new({
+            request_type: DatadogAPIClient::V1::DataProjectionRequestType::DATA_PROJECTION,
+            query: DatadogAPIClient::V1::DataProjectionQuery.new({
+              query_string: "service:web-store",
+              data_source: "logs",
+            }),
+            projection: DatadogAPIClient::V1::PointPlotProjection.new({
+              type: DatadogAPIClient::V1::PointPlotProjectionType::POINT_PLOT,
+              dimensions: [
+                DatadogAPIClient::V1::PointPlotProjectionDimension.new({
+                  column: "host",
+                  dimension: DatadogAPIClient::V1::PointPlotDimension::GROUP,
+                }),
+                DatadogAPIClient::V1::PointPlotProjectionDimension.new({
+                  column: "@duration",
+                  dimension: DatadogAPIClient::V1::PointPlotDimension::Y,
+                }),
+              ],
+            }),
+          }),
+        ],
+      }),
+    }),
+  ],
+})
+p api_instance.create_dashboard(body)

examples/v1/dashboards/CreateDashboard_2049446128.rb

@@ -739,6 +739,18 @@ Feature: Dashboards
     And the response "widgets[0].definition.type" is equal to "note"
     And the response "widgets[0].definition.content" is equal to "# Example Note"
 
+  @team:DataDog/dashboards-backend
+  Scenario: Create a new dashboard with point_plot widget
+    Given new "CreateDashboard" request
+    And body from file "dashboards_json_payload/point_plot_widget.json"
+    When the request is sent
+    Then the response status is 200 OK
+    And the response "widgets[0].definition.type" is equal to "point_plot"
+    And the response "widgets[0].definition.requests[0].request_type" is equal to "data_projection"
+    And the response "widgets[0].definition.requests[0].projection.type" is equal to "point_plot"
+    And the response "widgets[0].definition.requests[0].projection.dimensions[0].dimension" is equal to "group"
+    And the response "widgets[0].definition.requests[0].projection.dimensions[1].dimension" is equal to "y"
+
   @team:DataDog/dashboards-backend
   Scenario: Create a new dashboard with powerpack widget
     Given new "CreateDashboard" request

features/v1/dashboards.feature

@@ -0,0 +1,36 @@
+{
+   "title": "{{ unique }}",
+   "layout_type": "ordered",
+   "widgets": [
+      {
+         "definition": {
+            "title": "",
+            "title_size": "16",
+            "title_align": "left",
+            "type": "point_plot",
+            "requests": [
+               {
+                  "request_type": "data_projection",
+                  "query": {
+                     "query_string": "service:web-store",
+                     "data_source": "logs"
+                  },
+                  "projection": {
+                     "type": "point_plot",
+                     "dimensions": [
+                        {
+                           "column": "host",
+                           "dimension": "group"
+                        },
+                        {
+                           "column": "@duration",
+                           "dimension": "y"
+                        }
+                     ]
+                  }
+               }
+            ]
+         }
+      }
+   ]
+}

features/v1/dashboards_json_payload/point_plot_widget.json

@@ -103,6 +103,8 @@ def overrides
           "v1.dashboard_template_variable_preset" => "DashboardTemplateVariablePreset",
           "v1.dashboard_template_variable_preset_value" => "DashboardTemplateVariablePresetValue",
           "v1.dashboard_type" => "DashboardType",
+          "v1.data_projection_query" => "DataProjectionQuery",
+          "v1.data_projection_request_type" => "DataProjectionRequestType",
           "v1.deleted_monitor" => "DeletedMonitor",
           "v1.delete_shared_dashboard_response" => "DeleteSharedDashboardResponse",
           "v1.distribution_point_item" => "DistributionPointItem",
@@ -493,6 +495,15 @@ def overrides
           "v1.pager_duty_service_key" => "PagerDutyServiceKey",
           "v1.pager_duty_service_name" => "PagerDutyServiceName",
           "v1.pagination" => "Pagination",
+          "v1.point_plot_dimension" => "PointPlotDimension",
+          "v1.point_plot_projection" => "PointPlotProjection",
+          "v1.point_plot_projection_dimension" => "PointPlotProjectionDimension",
+          "v1.point_plot_projection_type" => "PointPlotProjectionType",
+          "v1.point_plot_widget_definition" => "PointPlotWidgetDefinition",
+          "v1.point_plot_widget_definition_type" => "PointPlotWidgetDefinitionType",
+          "v1.point_plot_widget_legend" => "PointPlotWidgetLegend",
+          "v1.point_plot_widget_legend_type" => "PointPlotWidgetLegendType",
+          "v1.point_plot_widget_request" => "PointPlotWidgetRequest",
           "v1.powerpack_template_variable_contents" => "PowerpackTemplateVariableContents",
           "v1.powerpack_template_variables" => "PowerpackTemplateVariables",
           "v1.powerpack_widget_definition" => "PowerpackWidgetDefinition",