Document estimate error responses and tag configuration 404 messages

.generator/schemas/v2/openapi.yaml

@@ -214873,6 +214873,11 @@ paths:
 
         To compare current volumes across many metrics, use `GET /api/v2/metrics` with `include=metric_volumes`
         instead of calling this endpoint for each metric.
+
+        A `404 Not Found` response means that no metric with this name exists in your organization. A
+        `400 Bad Request` response means that a query parameter is invalid, or that the metric has no data in the
+        queried window. For no data, the error message says so and names the window that was queried, which can
+        differ from the requested one.
       operationId: EstimateMetricsOutputSeries
       parameters:
         - $ref: "#/components/parameters/MetricName"
@@ -214894,7 +214899,7 @@ paths:
             type: boolean
         - description: |-
             The number of hours of look back (from now) to estimate cardinality with.
-            If unspecified, it defaults to 0 hours (the most recent data).
+            If unspecified, it defaults to 0 hours (the most recent data). Values below 0 return `400 Bad Request`.
           example: 0
           in: query
           name: filter[hours_ago]
@@ -214920,14 +214925,17 @@ paths:
           required: false
           schema:
             type: boolean
-        - description: A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.
+        - description: |-
+            A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.
+            Smaller values return `400 Bad Request`.
           example: 6
           in: query
           name: filter[timespan_h]
           required: false
           schema:
             format: int32
             maximum: 2147483647
+            minimum: 1
             type: integer
       responses:
         "200":
@@ -215398,9 +215406,9 @@ paths:
       description: |-
         Returns the tag configuration for the given metric name.
 
-        A metric may exist and submit data without having a tag configuration. A `404 Not Found` response usually
-        means that the metric has no tag configuration, but it is also returned when no metric with this name exists
-        in your organization.
+        A metric may exist and submit data without having a tag configuration. Both cases return `404 Not Found`,
+        with different messages: `No tag configuration for <metric_name>` when the metric exists without a tag
+        configuration, and `<metric_name> not found` when no metric with this name exists in your organization.
 
         To list tag configurations for many metrics, use `GET /api/v2/metrics` with `filter[configured]=true`
         instead of calling this endpoint for each metric.

src/main/java/com/datadog/api/client/v2/api/MetricsApi.java

@@ -1642,7 +1642,8 @@ public EstimateMetricsOutputSeriesOptionalParameters filterExcludeTagsMode(
      * Set filterHoursAgo.
      *
      * @param filterHoursAgo The number of hours of look back (from now) to estimate cardinality
-     *     with. If unspecified, it defaults to 0 hours (the most recent data). (optional)
+     *     with. If unspecified, it defaults to 0 hours (the most recent data). Values below 0
+     *     return <code>400 Bad Request</code>. (optional)
      * @return EstimateMetricsOutputSeriesOptionalParameters
      */
     public EstimateMetricsOutputSeriesOptionalParameters filterHoursAgo(Integer filterHoursAgo) {
@@ -1678,7 +1679,8 @@ public EstimateMetricsOutputSeriesOptionalParameters filterPct(Boolean filterPct
      * Set filterTimespanH.
      *
      * @param filterTimespanH A window, in hours, from the look back to estimate cardinality with.
-     *     The minimum and default is 1 hour. (optional)
+     *     The minimum and default is 1 hour. Smaller values return <code>400 Bad Request</code>.
+     *     (optional)
      * @return EstimateMetricsOutputSeriesOptionalParameters
      */
     public EstimateMetricsOutputSeriesOptionalParameters filterTimespanH(Integer filterTimespanH) {
@@ -1761,6 +1763,11 @@ public CompletableFuture<MetricEstimateResponse> estimateMetricsOutputSeriesAsyn
    * <p>To compare current volumes across many metrics, use <code>GET /api/v2/metrics</code> with
    * <code>include=metric_volumes</code> instead of calling this endpoint for each metric.
    *
+   * <p>A <code>404 Not Found</code> response means that no metric with this name exists in your
+   * organization. A <code>400 Bad Request</code> response means that a query parameter is invalid,
+   * or that the metric has no data in the queried window. For no data, the error message says so
+   * and names the window that was queried, which can differ from the requested one.
+   *
    * @param metricName The name of the metric. (required)
    * @param parameters Optional parameters for the request.
    * @return ApiResponse&lt;MetricEstimateResponse&gt;
@@ -3050,9 +3057,11 @@ public CompletableFuture<MetricTagConfigurationResponse> listTagConfigurationByN
   /**
    * Returns the tag configuration for the given metric name.
    *
-   * <p>A metric may exist and submit data without having a tag configuration. A <code>404 Not Found
-   * </code> response usually means that the metric has no tag configuration, but it is also
-   * returned when no metric with this name exists in your organization.
+   * <p>A metric may exist and submit data without having a tag configuration. Both cases return
+   * <code>404 Not Found</code>, with different messages: <code>
+   * No tag configuration for &lt;metric_name&gt;</code> when the metric exists without a tag
+   * configuration, and <code>&lt;metric_name&gt; not found</code> when no metric with this name
+   * exists in your organization.
    *
    * <p>To list tag configurations for many metrics, use <code>GET /api/v2/metrics</code> with
    * <code>filter[configured]=true</code> instead of calling this endpoint for each metric.