Document missing limitations and 409 response for org disable endpoint

.generator/schemas/v2/openapi.yaml

@@ -165498,6 +165498,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:
@@ -165546,6 +165558,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/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/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