Regenerate client from commit 497f78f of spec repo (#3066)

Co-authored-by: ci.datadog-api-spec <[email protected]>

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

.generator/schemas/v1/openapi.yaml

@@ -3448,9 +3448,10 @@ components:
             $ref: '#/components/schemas/WidgetCustomLink'
           type: array
         requests:
-          description: 'Array of one request object to display in the widget. The
-            request must contain a `group-by` tag whose value is a country ISO code.
-
+          description: 'Array of request objects to display in the widget. May include
+            an optional request for the region layer and/or an optional request for
+            the points layer. Region layer requests must contain a `group-by` tag
+            whose value is a country ISO code.
 
             See the [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json)
 
@@ -3461,7 +3462,7 @@ components:
                 query: <METRIC_1>{<SCOPE_1>}
           items:
             $ref: '#/components/schemas/GeomapWidgetRequest'
-          maxItems: 1
+          maxItems: 2
           minItems: 1
           type: array
         style:
@@ -3519,8 +3520,9 @@ components:
         focus: WORLD
       properties:
         focus:
-          description: The 2-letter ISO code of a country to focus the map on. Or
-            `WORLD`.
+          description: The 2-letter ISO code of a country to focus the map on, or
+            `WORLD` for global view, or a region (`EMEA`, `APAC`, `LATAM`), or a continent
+            (`NORTH_AMERICA`, `SOUTH_AMERICA`, `EUROPE`, `AFRICA`, `ASIA`, `OCEANIA`).
           example: WORLD
           type: string
       required:
@@ -3539,6 +3541,12 @@ components:
           items:
             $ref: '#/components/schemas/ListStreamColumn'
           type: array
+        conditional_formats:
+          description: Threshold (numeric) conditional formatting rules may be used
+            by a regions layer.
+          items:
+            $ref: '#/components/schemas/WidgetConditionalFormat'
+          type: array
         formulas:
           description: List of formulas that operate on queries.
           items:
@@ -3564,6 +3572,23 @@ components:
           $ref: '#/components/schemas/LogQueryDefinition'
         sort:
           $ref: '#/components/schemas/WidgetSortBy'
+        style:
+          $ref: '#/components/schemas/GeomapWidgetRequestStyle'
+        text_formats:
+          description: Text formatting rules may be used by a points layer.
+          items:
+            $ref: '#/components/schemas/TableWidgetTextFormatRule'
+          type: array
+      type: object
+    GeomapWidgetRequestStyle:
+      description: The style to apply to the request for points layer.
+      example:
+        color_by: status
+      properties:
+        color_by:
+          description: The category to color the points by.
+          example: status
+          type: string
       type: object
     GraphSnapshot:
       description: Object representing a graph snapshot.

cassettes/v1/Dashboards_1335235736/Create-a-geomap-widget-with-conditional-formats-and-text-formats_3581906349/frozen.json

@@ -0,0 +1 @@
+"2025-12-08T10:46:15.353Z"

cassettes/v1/Dashboards_1335235736/Create-a-geomap-widget-with-conditional-formats-and-text-formats_3581906349/recording.har

@@ -0,0 +1,110 @@
+{
+  "log": {
+    "_recordingName": "Dashboards/Create a geomap widget with conditional formats and text formats",
+    "creator": {
+      "comment": "persister:fs",
+      "name": "Polly.JS",
+      "version": "6.0.5"
+    },
+    "entries": [
+      {
+        "_id": "d20ad35b9db2e5d7ed599e12c501ec3d",
+        "_order": 0,
+        "cache": {},
+        "request": {
+          "bodySize": 1403,
+          "cookies": [],
+          "headers": [
+            {
+              "_fromType": "array",
+              "name": "accept",
+              "value": "application/json"
+            },
+            {
+              "_fromType": "array",
+              "name": "content-type",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 560,
+          "httpVersion": "HTTP/1.1",
+          "method": "POST",
+          "postData": {
+            "mimeType": "application/json",
+            "params": [],
+            "text": "{\"description\":\"Test-Create_a_geomap_widget_with_conditional_formats_and_text_formats-1765190775\",\"layout_type\":\"ordered\",\"notify_list\":[],\"reflow_type\":\"fixed\",\"tags\":[],\"template_variables\":[],\"title\":\"Test-Create_a_geomap_widget_with_conditional_formats_and_text_formats-1765190775\",\"widgets\":[{\"definition\":{\"requests\":[{\"conditional_formats\":[{\"comparator\":\">\",\"palette\":\"white_on_green\",\"value\":1000}],\"formulas\":[{\"formula\":\"query1\"}],\"queries\":[{\"compute\":{\"aggregation\":\"count\"},\"data_source\":\"rum\",\"group_by\":[],\"indexes\":[\"*\"],\"name\":\"query1\",\"search\":{\"query\":\"@type:session\"}}],\"response_format\":\"scalar\",\"sort\":{\"count\":250,\"order_by\":[{\"index\":0,\"order\":\"desc\",\"type\":\"formula\"}]}},{\"columns\":[{\"field\":\"@network.client.geoip.location.latitude\",\"width\":\"auto\"},{\"field\":\"@network.client.geoip.location.longitude\",\"width\":\"auto\"},{\"field\":\"@network.client.geoip.country.iso_code\",\"width\":\"auto\"},{\"field\":\"@network.client.geoip.subdivision.name\",\"width\":\"auto\"}],\"query\":{\"data_source\":\"logs_stream\",\"indexes\":[],\"query_string\":\"\",\"storage\":\"hot\"},\"response_format\":\"event_list\",\"style\":{\"color_by\":\"status\"},\"text_formats\":[{\"match\":{\"type\":\"is\",\"value\":\"error\"},\"palette\":\"white_on_red\"}]}],\"style\":{\"palette\":\"hostmap_blues\",\"palette_flip\":false},\"title\":\"Log Count by Service and Source\",\"type\":\"geomap\",\"view\":{\"focus\":\"NORTH_AMERICA\"}},\"layout\":{\"height\":6,\"width\":12,\"x\":0,\"y\":0}}]}"
+          },
+          "queryString": [],
+          "url": "https://api.datadoghq.com/api/v1/dashboard"
+        },
+        "response": {
+          "bodySize": 1736,
+          "content": {
+            "mimeType": "application/json",
+            "size": 1736,
+            "text": "{\"id\":\"n2i-h6d-x6a\",\"title\":\"Test-Create_a_geomap_widget_with_conditional_formats_and_text_formats-1765190775\",\"description\":\"Test-Create_a_geomap_widget_with_conditional_formats_and_text_formats-1765190775\",\"author_handle\":\"[email protected]\",\"author_name\":\"Shishi Liu\",\"layout_type\":\"ordered\",\"url\":\"/dashboard/n2i-h6d-x6a/test-createageomapwidgetwithconditionalformatsandtextformats-1765190775\",\"template_variables\":[],\"widgets\":[{\"definition\":{\"requests\":[{\"conditional_formats\":[{\"comparator\":\">\",\"palette\":\"white_on_green\",\"value\":1000}],\"formulas\":[{\"formula\":\"query1\"}],\"queries\":[{\"compute\":{\"aggregation\":\"count\"},\"data_source\":\"rum\",\"group_by\":[],\"indexes\":[\"*\"],\"name\":\"query1\",\"search\":{\"query\":\"@type:session\"}}],\"response_format\":\"scalar\",\"sort\":{\"count\":250,\"order_by\":[{\"index\":0,\"order\":\"desc\",\"type\":\"formula\"}]}},{\"columns\":[{\"field\":\"@network.client.geoip.location.latitude\",\"width\":\"auto\"},{\"field\":\"@network.client.geoip.location.longitude\",\"width\":\"auto\"},{\"field\":\"@network.client.geoip.country.iso_code\",\"width\":\"auto\"},{\"field\":\"@network.client.geoip.subdivision.name\",\"width\":\"auto\"}],\"query\":{\"data_source\":\"logs_stream\",\"indexes\":[],\"query_string\":\"\",\"storage\":\"hot\"},\"response_format\":\"event_list\",\"style\":{\"color_by\":\"status\"},\"text_formats\":[{\"match\":{\"type\":\"is\",\"value\":\"error\"},\"palette\":\"white_on_red\"}]}],\"style\":{\"palette\":\"hostmap_blues\",\"palette_flip\":false},\"title\":\"Log Count by Service and Source\",\"type\":\"geomap\",\"view\":{\"focus\":\"NORTH_AMERICA\"}},\"layout\":{\"height\":6,\"width\":12,\"x\":0,\"y\":0},\"id\":4916490421180340}],\"notify_list\":[],\"created_at\":\"2025-12-08T10:46:15.791396+00:00\",\"modified_at\":\"2025-12-08T10:46:15.791396+00:00\",\"reflow_type\":\"fixed\",\"tags\":[],\"restricted_roles\":[]}"
+          },
+          "cookies": [],
+          "headers": [
+            {
+              "name": "content-type",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 381,
+          "httpVersion": "HTTP/1.1",
+          "redirectURL": "",
+          "status": 200,
+          "statusText": "OK"
+        },
+        "startedDateTime": "2025-12-08T10:46:15.368Z",
+        "time": 540
+      },
+      {
+        "_id": "47b9d68833554d5352921b2bc1461606",
+        "_order": 0,
+        "cache": {},
+        "request": {
+          "bodySize": 0,
+          "cookies": [],
+          "headers": [
+            {
+              "_fromType": "array",
+              "name": "accept",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 520,
+          "httpVersion": "HTTP/1.1",
+          "method": "DELETE",
+          "queryString": [],
+          "url": "https://api.datadoghq.com/api/v1/dashboard/n2i-h6d-x6a"
+        },
+        "response": {
+          "bodySize": 38,
+          "content": {
+            "mimeType": "application/json",
+            "size": 38,
+            "text": "{\"deleted_dashboard_id\":\"n2i-h6d-x6a\"}"
+          },
+          "cookies": [],
+          "headers": [
+            {
+              "name": "content-type",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 379,
+          "httpVersion": "HTTP/1.1",
+          "redirectURL": "",
+          "status": 200,
+          "statusText": "OK"
+        },
+        "startedDateTime": "2025-12-08T10:46:15.943Z",
+        "time": 640
+      }
+    ],
+    "pages": [],
+    "version": "1.2"
+  }
+}

examples/v1/dashboards/CreateDashboard_9836563.ts

@@ -0,0 +1,130 @@
+/**
+ * Create a geomap widget with conditional formats and text formats
+ */
+
+import { client, v1 } from "@datadog/datadog-api-client";
+
+const configuration = client.createConfiguration();
+const apiInstance = new v1.DashboardsApi(configuration);
+
+const params: v1.DashboardsApiCreateDashboardRequest = {
+  body: {
+    title: "Example-Dashboard",
+    description: "Example-Dashboard",
+    widgets: [
+      {
+        definition: {
+          title: "Log Count by Service and Source",
+          type: "geomap",
+          requests: [
+            {
+              responseFormat: "scalar",
+              queries: [
+                {
+                  dataSource: "rum",
+                  name: "query1",
+                  search: {
+                    query: "@type:session",
+                  },
+                  indexes: ["*"],
+                  compute: {
+                    aggregation: "count",
+                  },
+                  groupBy: [],
+                },
+              ],
+              conditionalFormats: [
+                {
+                  comparator: ">",
+                  value: 1000,
+                  palette: "white_on_green",
+                },
+              ],
+              formulas: [
+                {
+                  formula: "query1",
+                },
+              ],
+              sort: {
+                count: 250,
+                orderBy: [
+                  {
+                    type: "formula",
+                    index: 0,
+                    order: "desc",
+                  },
+                ],
+              },
+            },
+            {
+              responseFormat: "event_list",
+              query: {
+                dataSource: "logs_stream",
+                queryString: "",
+                indexes: [],
+                storage: "hot",
+              },
+              columns: [
+                {
+                  field: "@network.client.geoip.location.latitude",
+                  width: "auto",
+                },
+                {
+                  field: "@network.client.geoip.location.longitude",
+                  width: "auto",
+                },
+                {
+                  field: "@network.client.geoip.country.iso_code",
+                  width: "auto",
+                },
+                {
+                  field: "@network.client.geoip.subdivision.name",
+                  width: "auto",
+                },
+              ],
+              style: {
+                colorBy: "status",
+              },
+              textFormats: [
+                {
+                  match: {
+                    type: "is",
+                    value: "error",
+                  },
+                  palette: "white_on_red",
+                },
+              ],
+            },
+          ],
+          style: {
+            palette: "hostmap_blues",
+            paletteFlip: false,
+          },
+          view: {
+            focus: "NORTH_AMERICA",
+          },
+        },
+        layout: {
+          x: 0,
+          y: 0,
+          width: 12,
+          height: 6,
+        },
+      },
+    ],
+    templateVariables: [],
+    layoutType: "ordered",
+    notifyList: [],
+    reflowType: "fixed",
+    tags: [],
+  },
+};
+
+apiInstance
+  .createDashboard(params)
+  .then((data: v1.Dashboard) => {
+    console.log(
+      "API called successfully. Returned data: " + JSON.stringify(data)
+    );
+  })
+  .catch((error: any) => console.error(error));

features/v1/dashboards.feature

@@ -72,6 +72,22 @@ Feature: Dashboards
     And the response "widgets[0].definition.requests[0].response_format" is equal to "event_list"
     And the response "widgets[0].definition.requests[0].query.data_source" is equal to "logs_stream"
 
+  @team:DataDog/dashboards-backend
+  Scenario: Create a geomap widget with conditional formats and text formats
+    Given new "CreateDashboard" request
+    And body with value {"title": "{{ unique }}","description": "{{ unique }}","widgets":[{"definition":{"title":"Log Count by Service and Source","type":"geomap","requests":[{"response_format":"scalar","queries":[{"data_source":"rum","name":"query1","search":{"query":"@type:session"},"indexes":["*"],"compute":{"aggregation":"count"},"group_by":[]}],"conditional_formats":[{"comparator":">","value":1000,"palette":"white_on_green"}],"formulas":[{"formula":"query1"}],"sort":{"count":250,"order_by":[{"type":"formula","index":0,"order":"desc"}]}},{"response_format":"event_list","query":{"data_source":"logs_stream","query_string":"","indexes":[],"storage":"hot"},"columns":[{"field":"@network.client.geoip.location.latitude","width":"auto"},{"field":"@network.client.geoip.location.longitude","width":"auto"},{"field":"@network.client.geoip.country.iso_code","width":"auto"},{"field":"@network.client.geoip.subdivision.name","width":"auto"}],"style":{"color_by":"status"},"text_formats":[{"match":{"type":"is","value":"error"},"palette":"white_on_red"}]}],"style":{"palette":"hostmap_blues","palette_flip":false},"view":{"focus":"NORTH_AMERICA"}},"layout":{"x":0,"y":0,"width":12,"height":6}}],"template_variables":[],"layout_type":"ordered","notify_list":[],"reflow_type":"fixed","tags":[]}
+    When the request is sent
+    Then the response status is 200 OK
+    And the response "widgets[0].definition.type" is equal to "geomap"
+    And the response "widgets[0].definition.title" is equal to "Log Count by Service and Source"
+    And the response "widgets[0].definition.requests[0].conditional_formats[0].comparator" is equal to ">"
+    And the response "widgets[0].definition.requests[0].conditional_formats[0].palette" is equal to "white_on_green"
+    And the response "widgets[0].definition.requests[0].conditional_formats[0].value" is equal to 1000
+    And the response "widgets[0].definition.requests[1].text_formats[0].match.type" is equal to "is"
+    And the response "widgets[0].definition.requests[1].text_formats[0].match.value" is equal to "error"
+    And the response "widgets[0].definition.requests[1].text_formats[0].palette" is equal to "white_on_red"
+    And the response "widgets[0].definition.view.focus" is equal to "NORTH_AMERICA"
+
   @generated @skip @team:DataDog/dashboards-backend
   Scenario: Create a new dashboard returns "Bad Request" response
     Given new "CreateDashboard" request

packages/datadog-api-client-v1/index.ts

@@ -485,6 +485,7 @@ export { GeomapWidgetDefinitionStyle } from "./models/GeomapWidgetDefinitionStyl
 export { GeomapWidgetDefinitionType } from "./models/GeomapWidgetDefinitionType";
 export { GeomapWidgetDefinitionView } from "./models/GeomapWidgetDefinitionView";
 export { GeomapWidgetRequest } from "./models/GeomapWidgetRequest";
+export { GeomapWidgetRequestStyle } from "./models/GeomapWidgetRequestStyle";
 export { GraphSnapshot } from "./models/GraphSnapshot";
 export { GroupType } from "./models/GroupType";
 export { GroupWidgetDefinition } from "./models/GroupWidgetDefinition";

packages/datadog-api-client-v1/models/GeomapWidgetDefinition.ts

@@ -22,12 +22,11 @@ export class GeomapWidgetDefinition {
    */
   "customLinks"?: Array<WidgetCustomLink>;
   /**
-   * Array of one request object to display in the widget. The request must contain a `group-by` tag whose value is a country ISO code.
-   *
+   * Array of request objects to display in the widget. May include an optional request for the region layer and/or an optional request for the points layer. Region layer requests must contain a `group-by` tag whose value is a country ISO code.
    * See the [Request JSON schema documentation](https://docs.datadoghq.com/dashboards/graphing_json/request_json)
    * for information about building the `REQUEST_SCHEMA`.
    */
-  "requests": [GeomapWidgetRequest];
+  "requests": Array<GeomapWidgetRequest>;
   /**
    * The style to apply to the widget.
    */
@@ -79,7 +78,7 @@ export class GeomapWidgetDefinition {
     },
     requests: {
       baseName: "requests",
-      type: "[GeomapWidgetRequest]",
+      type: "Array<GeomapWidgetRequest>",
       required: true,
     },
     style: {

packages/datadog-api-client-v1/models/GeomapWidgetDefinitionView.ts

@@ -11,7 +11,7 @@ import { AttributeTypeMap } from "../../datadog-api-client-common/util";
  */
 export class GeomapWidgetDefinitionView {
   /**
-   * The 2-letter ISO code of a country to focus the map on. Or `WORLD`.
+   * The 2-letter ISO code of a country to focus the map on, or `WORLD` for global view, or a region (`EMEA`, `APAC`, `LATAM`), or a continent (`NORTH_AMERICA`, `SOUTH_AMERICA`, `EUROPE`, `AFRICA`, `ASIA`, `OCEANIA`).
    */
   "focus": string;