Update widget's properties' description (#3671)

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

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

.generator/schemas/v1/openapi.yaml

@@ -3368,8 +3368,10 @@ components:
       x-enum-varnames:
         - FORMULA
     FreeTextWidgetDefinition:
-      description: Free text is a widget that allows you to add headings to your screenboard. Commonly used to state the overall purpose of the dashboard. Only available on FREE layout dashboards.
+      description: Free text is a widget that allows you to add headings to your dashboard. Commonly used to state the overall purpose of the dashboard.
       properties:
+        background_color:
+          $ref: "#/components/schemas/WidgetBackgroundColor"
         color:
           description: Color of the text.
           type: string
@@ -3810,11 +3812,10 @@ components:
       x-enum-varnames:
         - GROUP
     GroupWidgetDefinition:
-      description: The groups widget allows you to keep similar graphs together on your timeboard. Each group has a custom header, can hold one to many graphs, and is collapsible.
+      description: The group widget allows you to keep similar graphs together on your dashboard. Each group has a custom header, can hold one to many graphs, and is collapsible.
       properties:
         background_color:
-          description: Background color of the group title.
-          type: string
+          $ref: "#/components/schemas/WidgetBackgroundColor"
         banner_img:
           description: URL of image to display as a banner for the group.
           type: string
@@ -4672,7 +4673,7 @@ components:
         - VULN_MANAGEMENT_HOSTS_USAGE
         - WORKFLOW_EXECUTIONS_USAGE
     IFrameWidgetDefinition:
-      description: The iframe widget allows you to embed a portion of any other web page on your dashboard. Only available on FREE layout dashboards.
+      description: The iframe widget allows you to embed a portion of any other web page on your dashboard.
       properties:
         type:
           $ref: "#/components/schemas/IFrameWidgetDefinitionType"
@@ -4944,7 +4945,7 @@ components:
         - message
       type: object
     ImageWidgetDefinition:
-      description: The image widget allows you to embed an image on your dashboard. An image can be a PNG, JPG, or animated GIF. Only available on FREE layout dashboards.
+      description: The image widget allows you to embed an image on your dashboard. An image can be a PNG, JPG, or animated GIF.
       properties:
         has_background:
           default: true
@@ -5345,7 +5346,7 @@ components:
         - query
       type: object
     LogStreamWidgetDefinition:
-      description: The Log Stream displays a log flow matching the defined query. Only available on FREE layout dashboards.
+      description: The Log Stream displays a log flow matching the defined query.
       properties:
         columns:
           description: Which columns to display on the widget.
@@ -8766,7 +8767,7 @@ components:
           $ref: "#/components/schemas/MonitorOverallStates"
       type: object
     MonitorSummaryWidgetDefinition:
-      description: The monitor summary widget displays a summary view of all your Datadog monitors, or a subset based on a query. Only available on FREE layout dashboards.
+      description: The monitor summary widget displays a summary view of all your Datadog monitors, or a subset based on a query.
       properties:
         color_preference:
           $ref: "#/components/schemas/WidgetColorPreference"
@@ -12897,7 +12898,7 @@ components:
         - METRIC
         - TIME_SLICE
     SLOWidgetDefinition:
-      description: Use the SLO and uptime widget to track your SLOs (Service Level Objectives) and uptime on screenboards and timeboards.
+      description: Use the SLO and uptime widget to track your SLOs (Service Level Objectives) and uptime on dashboards.
       properties:
         additional_query_filters:
           description: Additional filters applied to the SLO query.
@@ -14108,7 +14109,7 @@ components:
       x-enum-varnames:
         - SERVICEMAP
     ServiceSummaryWidgetDefinition:
-      description: The service summary displays the graphs of a chosen service in your screenboard. Only available on FREE layout dashboards.
+      description: The service summary displays the graphs of a chosen service in your dashboard.
       properties:
         description:
           description: The description of the widget.
@@ -18657,7 +18658,7 @@ components:
         - BAR
         - TREND
     TableWidgetDefinition:
-      description: The table visualization is available on timeboards and screenboards. It displays columns of metrics grouped by tag key.
+      description: The table visualization is available on dashboards. It displays columns of metrics grouped by tag key.
       properties:
         custom_links:
           description: List of custom links.
@@ -24139,6 +24140,9 @@ components:
           description: Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, and `pow##` (for example `pow2` or `pow0.5`).
           type: string
       type: object
+    WidgetBackgroundColor:
+      description: "Background color of the widget. Supported values are `white`, `blue`, `purple`, `pink`, `orange`, `yellow`, `green`, `gray`, `vivid_blue`, `vivid_purple`, `vivid_pink`, `vivid_orange`, `vivid_yellow`, `vivid_green`, and `transparent`."
+      type: string
     WidgetChangeType:
       description: Show the absolute or the relative change.
       enum:

src/main/java/com/datadog/api/client/v1/model/FreeTextWidgetDefinition.java

@@ -18,10 +18,11 @@
 import java.util.Objects;
 
 /**
- * Free text is a widget that allows you to add headings to your screenboard. Commonly used to state
- * the overall purpose of the dashboard. Only available on FREE layout dashboards.
+ * Free text is a widget that allows you to add headings to your dashboard. Commonly used to state
+ * the overall purpose of the dashboard.
  */
 @JsonPropertyOrder({
+  FreeTextWidgetDefinition.JSON_PROPERTY_BACKGROUND_COLOR,
   FreeTextWidgetDefinition.JSON_PROPERTY_COLOR,
   FreeTextWidgetDefinition.JSON_PROPERTY_FONT_SIZE,
   FreeTextWidgetDefinition.JSON_PROPERTY_TEXT,
@@ -32,6 +33,9 @@
     value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")
 public class FreeTextWidgetDefinition {
   @JsonIgnore public boolean unparsed = false;
+  public static final String JSON_PROPERTY_BACKGROUND_COLOR = "background_color";
+  private String backgroundColor;
+
   public static final String JSON_PROPERTY_COLOR = "color";
   private String color;
 
@@ -59,6 +63,31 @@ public FreeTextWidgetDefinition(
     this.unparsed |= !type.isValid();
   }
 
+  public FreeTextWidgetDefinition backgroundColor(String backgroundColor) {
+    this.backgroundColor = backgroundColor;
+    return this;
+  }
+
+  /**
+   * Background color of the widget. Supported values are <code>white</code>, <code>blue</code>,
+   * <code>purple</code>, <code>pink</code>, <code>orange</code>, <code>yellow</code>, <code>green
+   * </code>, <code>gray</code>, <code>vivid_blue</code>, <code>vivid_purple</code>, <code>
+   * vivid_pink</code>, <code>vivid_orange</code>, <code>vivid_yellow</code>, <code>vivid_green
+   * </code>, and <code>transparent</code>.
+   *
+   * @return backgroundColor
+   */
+  @jakarta.annotation.Nullable
+  @JsonProperty(JSON_PROPERTY_BACKGROUND_COLOR)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public String getBackgroundColor() {
+    return backgroundColor;
+  }
+
+  public void setBackgroundColor(String backgroundColor) {
+    this.backgroundColor = backgroundColor;
+  }
+
   public FreeTextWidgetDefinition color(String color) {
     this.color = color;
     return this;
@@ -226,7 +255,8 @@ public boolean equals(Object o) {
       return false;
     }
     FreeTextWidgetDefinition freeTextWidgetDefinition = (FreeTextWidgetDefinition) o;
-    return Objects.equals(this.color, freeTextWidgetDefinition.color)
+    return Objects.equals(this.backgroundColor, freeTextWidgetDefinition.backgroundColor)
+        && Objects.equals(this.color, freeTextWidgetDefinition.color)
         && Objects.equals(this.fontSize, freeTextWidgetDefinition.fontSize)
         && Objects.equals(this.text, freeTextWidgetDefinition.text)
         && Objects.equals(this.textAlign, freeTextWidgetDefinition.textAlign)
@@ -236,13 +266,15 @@ public boolean equals(Object o) {
 
   @Override
   public int hashCode() {
-    return Objects.hash(color, fontSize, text, textAlign, type, additionalProperties);
+    return Objects.hash(
+        backgroundColor, color, fontSize, text, textAlign, type, additionalProperties);
   }
 
   @Override
   public String toString() {
     StringBuilder sb = new StringBuilder();
     sb.append("class FreeTextWidgetDefinition {\n");
+    sb.append("    backgroundColor: ").append(toIndentedString(backgroundColor)).append("\n");
     sb.append("    color: ").append(toIndentedString(color)).append("\n");
     sb.append("    fontSize: ").append(toIndentedString(fontSize)).append("\n");
     sb.append("    text: ").append(toIndentedString(text)).append("\n");

src/main/java/com/datadog/api/client/v1/model/GroupWidgetDefinition.java

@@ -20,7 +20,7 @@
 import java.util.Objects;
 
 /**
- * The groups widget allows you to keep similar graphs together on your timeboard. Each group has a
+ * The group widget allows you to keep similar graphs together on your dashboard. Each group has a
  * custom header, can hold one to many graphs, and is collapsible.
  */
 @JsonPropertyOrder({
@@ -81,7 +81,11 @@ public GroupWidgetDefinition backgroundColor(String backgroundColor) {
   }
 
   /**
-   * Background color of the group title.
+   * Background color of the widget. Supported values are <code>white</code>, <code>blue</code>,
+   * <code>purple</code>, <code>pink</code>, <code>orange</code>, <code>yellow</code>, <code>green
+   * </code>, <code>gray</code>, <code>vivid_blue</code>, <code>vivid_purple</code>, <code>
+   * vivid_pink</code>, <code>vivid_orange</code>, <code>vivid_yellow</code>, <code>vivid_green
+   * </code>, and <code>transparent</code>.
    *
    * @return backgroundColor
    */

src/main/java/com/datadog/api/client/v1/model/IFrameWidgetDefinition.java

@@ -17,10 +17,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/**
- * The iframe widget allows you to embed a portion of any other web page on your dashboard. Only
- * available on FREE layout dashboards.
- */
+/** The iframe widget allows you to embed a portion of any other web page on your dashboard. */
 @JsonPropertyOrder({
   IFrameWidgetDefinition.JSON_PROPERTY_TYPE,
   IFrameWidgetDefinition.JSON_PROPERTY_URL

src/main/java/com/datadog/api/client/v1/model/ImageWidgetDefinition.java

@@ -19,7 +19,7 @@
 
 /**
  * The image widget allows you to embed an image on your dashboard. An image can be a PNG, JPG, or
- * animated GIF. Only available on FREE layout dashboards.
+ * animated GIF.
  */
 @JsonPropertyOrder({
   ImageWidgetDefinition.JSON_PROPERTY_HAS_BACKGROUND,

src/main/java/com/datadog/api/client/v1/model/LogStreamWidgetDefinition.java

@@ -19,10 +19,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/**
- * The Log Stream displays a log flow matching the defined query. Only available on FREE layout
- * dashboards.
- */
+/** The Log Stream displays a log flow matching the defined query. */
 @JsonPropertyOrder({
   LogStreamWidgetDefinition.JSON_PROPERTY_COLUMNS,
   LogStreamWidgetDefinition.JSON_PROPERTY_DESCRIPTION,

src/main/java/com/datadog/api/client/v1/model/MonitorSummaryWidgetDefinition.java

@@ -19,7 +19,7 @@
 
 /**
  * The monitor summary widget displays a summary view of all your Datadog monitors, or a subset
- * based on a query. Only available on FREE layout dashboards.
+ * based on a query.
  */
 @JsonPropertyOrder({
   MonitorSummaryWidgetDefinition.JSON_PROPERTY_COLOR_PREFERENCE,

src/main/java/com/datadog/api/client/v1/model/NotebookLogStreamCellAttributes.java

@@ -54,8 +54,7 @@ public NotebookLogStreamCellAttributes definition(LogStreamWidgetDefinition defi
   }
 
   /**
-   * The Log Stream displays a log flow matching the defined query. Only available on FREE layout
-   * dashboards.
+   * The Log Stream displays a log flow matching the defined query.
    *
    * @return definition
    */

src/main/java/com/datadog/api/client/v1/model/SLOWidgetDefinition.java

@@ -21,7 +21,7 @@
 
 /**
  * Use the SLO and uptime widget to track your SLOs (Service Level Objectives) and uptime on
- * screenboards and timeboards.
+ * dashboards.
  */
 @JsonPropertyOrder({
   SLOWidgetDefinition.JSON_PROPERTY_ADDITIONAL_QUERY_FILTERS,

src/main/java/com/datadog/api/client/v1/model/ServiceSummaryWidgetDefinition.java

@@ -17,10 +17,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/**
- * The service summary displays the graphs of a chosen service in your screenboard. Only available
- * on FREE layout dashboards.
- */
+/** The service summary displays the graphs of a chosen service in your dashboard. */
 @JsonPropertyOrder({
   ServiceSummaryWidgetDefinition.JSON_PROPERTY_DESCRIPTION,
   ServiceSummaryWidgetDefinition.JSON_PROPERTY_DISPLAY_FORMAT,