Document missing limitations and 409 response for org disable endpoint

.generator/schemas/v2/openapi.yaml

@@ -31063,9 +31063,17 @@ components:
           type: string
         values:
           description: |-
-            Column values in row order. The element type matches the column's `type`;
-            for example a `VARCHAR` column carries strings, a `TIMESTAMP` column carries
-            Unix-millisecond integers. `null` is allowed for missing values.
+            Column values in row order, one entry per result row. The element type
+            follows the column's `type`. The following serialization rules should be
+            taken into account:
+
+            - `BIGINT` values are encoded as JSON numbers in the signed 64-bit integer range.
+            - `DECIMAL` values are encoded as JSON numbers with 64-bit double precision.
+            - `TIMESTAMP` and `DATE` values are encoded as Unix-millisecond integers; a
+              `DATE` resolves to midnight UTC.
+            - `JSON` values are returned as a JSON-encoded string.
+
+            `null` is allowed for any column type where a value is missing.
           example:
             - web-store
             - checkout
@@ -135602,9 +135610,6 @@ paths:
       summary: Execute a tabular DDSQL query
       tags:
         - DDSQL
-      x-unstable: |-
-        **Note**: This endpoint is in preview and is subject to change.
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/ddsql/query/tabular/fetch:
     post:
       description: |-
@@ -135713,9 +135718,6 @@ paths:
       summary: Fetch the result of a DDSQL query
       tags:
         - DDSQL
-      x-unstable: |-
-        **Note**: This endpoint is in preview and is subject to change.
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/deletion/data/{product}:
     post:
       description: Creates a data deletion request by providing a query and a timeframe targeting the proper data.
@@ -166072,6 +166074,18 @@ paths:
         the authenticated org or the request is rejected. Successful calls disable the org
         and return the resulting state from the downstream service. Requires the
         `org_management` permission.
+
+        **Limitations**:
+
+        - **Organization age**: Only organizations created within the last 10 days can be disabled
+          through this endpoint. This restriction is a safeguard against accidentally disabling
+          long-running organizations. Attempting to disable an older organization returns a `403 Forbidden`.
+        - **Feature flag**: The feature flag `org_disable_self_service_enabled` must be enabled for the
+          target organization or one of its ancestor organizations. Contact
+          [Datadog support](https://docs.datadoghq.com/help/) to enable this for your organization.
+          Requests for organizations without this flag return a `403 Forbidden`.
+        - **Already-disabled organizations**: If the target organization is already disabled, the request
+          returns a `409 Conflict`.
       operationId: DisableCustomerOrg
       requestBody:
         content:
@@ -166120,6 +166134,12 @@ paths:
               schema:
                 $ref: "#/components/schemas/JSONAPIErrorResponse"
           description: Forbidden
+        "409":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Conflict
         "429":
           $ref: "#/components/responses/TooManyRequestsResponse"
         "500":

src/main/java/com/datadog/api/client/ApiClient.java

@@ -1004,8 +1004,6 @@ public class ApiClient {
           put("v2.getAllDatasets", false);
           put("v2.getDataset", false);
           put("v2.updateDataset", false);
-          put("v2.executeDdsqlTabularQuery", false);
-          put("v2.fetchDdsqlTabularQuery", false);
           put("v2.cancelDataDeletionRequest", false);
           put("v2.createDataDeletionRequest", false);
           put("v2.getDataDeletionRequests", false);

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

@@ -82,6 +82,22 @@ public CompletableFuture<CustomerOrgDisableResponse> disableCustomerOrgAsync(
    * resulting state from the downstream service. Requires the <code>org_management</code>
    * permission.
    *
+   * <p><strong>Limitations</strong>:
+   *
+   * <ul>
+   *   <li><strong>Organization age</strong>: Only organizations created within the last 10 days can
+   *       be disabled through this endpoint. This restriction is a safeguard against accidentally
+   *       disabling long-running organizations. Attempting to disable an older organization returns
+   *       a <code>403 Forbidden</code>.
+   *   <li><strong>Feature flag</strong>: The feature flag <code>org_disable_self_service_enabled
+   *       </code> must be enabled for the target organization or one of its ancestor organizations.
+   *       Contact <a href="https://docs.datadoghq.com/help/">Datadog support</a> to enable this for
+   *       your organization. Requests for organizations without this flag return a <code>
+   *       403 Forbidden</code>.
+   *   <li><strong>Already-disabled organizations</strong>: If the target organization is already
+   *       disabled, the request returns a <code>409 Conflict</code>.
+   * </ul>
+   *
    * @param body (required)
    * @return ApiResponse&lt;CustomerOrgDisableResponse&gt;
    * @throws ApiException if fails to make API call
@@ -93,6 +109,7 @@ public CompletableFuture<CustomerOrgDisableResponse> disableCustomerOrgAsync(
    *       <tr><td> 400 </td><td> Bad Request </td><td>  -  </td></tr>
    *       <tr><td> 401 </td><td> Unauthorized </td><td>  -  </td></tr>
    *       <tr><td> 403 </td><td> Forbidden </td><td>  -  </td></tr>
+   *       <tr><td> 409 </td><td> Conflict </td><td>  -  </td></tr>
    *       <tr><td> 429 </td><td> Too many requests </td><td>  -  </td></tr>
    *       <tr><td> 500 </td><td> Internal Server Error </td><td>  -  </td></tr>
    *     </table>

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

@@ -97,13 +97,6 @@ public CompletableFuture<DdsqlTabularQueryResponse> executeDdsqlTabularQueryAsyn
    */
   public ApiResponse<DdsqlTabularQueryResponse> executeDdsqlTabularQueryWithHttpInfo(
       DdsqlTabularQueryRequest body) throws ApiException {
-    // Check if unstable operation is enabled
-    String operationId = "executeDdsqlTabularQuery";
-    if (apiClient.isUnstableOperationEnabled("v2." + operationId)) {
-      apiClient.getLogger().warning(String.format("Using unstable operation '%s'", operationId));
-    } else {
-      throw new ApiException(0, String.format("Unstable operation '%s' is disabled", operationId));
-    }
     Object localVarPostBody = body;
 
     // verify the required parameter 'body' is set
@@ -146,16 +139,6 @@ public ApiResponse<DdsqlTabularQueryResponse> executeDdsqlTabularQueryWithHttpIn
    */
   public CompletableFuture<ApiResponse<DdsqlTabularQueryResponse>>
       executeDdsqlTabularQueryWithHttpInfoAsync(DdsqlTabularQueryRequest body) {
-    // Check if unstable operation is enabled
-    String operationId = "executeDdsqlTabularQuery";
-    if (apiClient.isUnstableOperationEnabled("v2." + operationId)) {
-      apiClient.getLogger().warning(String.format("Using unstable operation '%s'", operationId));
-    } else {
-      CompletableFuture<ApiResponse<DdsqlTabularQueryResponse>> result = new CompletableFuture<>();
-      result.completeExceptionally(
-          new ApiException(0, String.format("Unstable operation '%s' is disabled", operationId)));
-      return result;
-    }
     Object localVarPostBody = body;
 
     // verify the required parameter 'body' is set
@@ -252,13 +235,6 @@ public CompletableFuture<DdsqlTabularQueryResponse> fetchDdsqlTabularQueryAsync(
    */
   public ApiResponse<DdsqlTabularQueryResponse> fetchDdsqlTabularQueryWithHttpInfo(
       DdsqlTabularQueryFetchRequest body) throws ApiException {
-    // Check if unstable operation is enabled
-    String operationId = "fetchDdsqlTabularQuery";
-    if (apiClient.isUnstableOperationEnabled("v2." + operationId)) {
-      apiClient.getLogger().warning(String.format("Using unstable operation '%s'", operationId));
-    } else {
-      throw new ApiException(0, String.format("Unstable operation '%s' is disabled", operationId));
-    }
     Object localVarPostBody = body;
 
     // verify the required parameter 'body' is set
@@ -301,16 +277,6 @@ public ApiResponse<DdsqlTabularQueryResponse> fetchDdsqlTabularQueryWithHttpInfo
    */
   public CompletableFuture<ApiResponse<DdsqlTabularQueryResponse>>
       fetchDdsqlTabularQueryWithHttpInfoAsync(DdsqlTabularQueryFetchRequest body) {
-    // Check if unstable operation is enabled
-    String operationId = "fetchDdsqlTabularQuery";
-    if (apiClient.isUnstableOperationEnabled("v2." + operationId)) {
-      apiClient.getLogger().warning(String.format("Using unstable operation '%s'", operationId));
-    } else {
-      CompletableFuture<ApiResponse<DdsqlTabularQueryResponse>> result = new CompletableFuture<>();
-      result.completeExceptionally(
-          new ApiException(0, String.format("Unstable operation '%s' is disabled", operationId)));
-      return result;
-    }
     Object localVarPostBody = body;
 
     // verify the required parameter 'body' is set

src/main/java/com/datadog/api/client/v2/model/DdsqlTabularQueryColumn.java

@@ -105,9 +105,19 @@ public DdsqlTabularQueryColumn addValuesItem(Object valuesItem) {
   }
 
   /**
-   * Column values in row order. The element type matches the column's <code>type</code>; for
-   * example a <code>VARCHAR</code> column carries strings, a <code>TIMESTAMP</code> column carries
-   * Unix-millisecond integers. <code>null</code> is allowed for missing values.
+   * Column values in row order, one entry per result row. The element type follows the column's
+   * <code>type</code>. The following serialization rules should be taken into account:
+   *
+   * <ul>
+   *   <li><code>BIGINT</code> values are encoded as JSON numbers in the signed 64-bit integer
+   *       range.
+   *   <li><code>DECIMAL</code> values are encoded as JSON numbers with 64-bit double precision.
+   *   <li><code>TIMESTAMP</code> and <code>DATE</code> values are encoded as Unix-millisecond
+   *       integers; a <code>DATE</code> resolves to midnight UTC.
+   *   <li><code>JSON</code> values are returned as a JSON-encoded string.
+   * </ul>
+   *
+   * <p><code>null</code> is allowed for any column type where a value is missing.
    *
    * @return values
    */

src/test/resources/com/datadog/api/client/v2/api/customer_org.feature

@@ -17,6 +17,11 @@ Feature: Customer Org
     When the request is sent
     Then the response status is 400 Bad Request
 
+  @generated @skip @team:DataDog/org-management
+  Scenario: Disable the authenticated customer organization returns "Conflict" response
+    When the request is sent
+    Then the response status is 409 Conflict
+
   @generated @skip @team:DataDog/org-management
   Scenario: Disable the authenticated customer organization returns "OK" response
     When the request is sent