Regenerate client from commit c875c84 of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -39838,6 +39838,10 @@ components:
           example: b51f08b698d88d8027a935d9db649774949f5fb41a0c559bfee6a9a13225c72d
           nullable: true
           type: string
+        has_ever_been_published:
+          description: Whether this version number has ever appeared in the form's publication history.
+          example: true
+          type: boolean
         id:
           description: The ID of the form version.
           example: "126"
@@ -39894,6 +39898,15 @@ components:
         - type
         - attributes
       type: object
+    FormVersionListType:
+      default: form_version_lists
+      description: The resource type for a list of form versions.
+      enum:
+        - form_version_lists
+      example: form_version_lists
+      type: string
+      x-enum-varnames:
+        - FORM_VERSION_LISTS
     FormVersionResponse:
       description: A response containing a single form version.
       properties:
@@ -57900,6 +57913,41 @@ components:
         - data
         - meta
       type: object
+    ListFormVersionsData:
+      description: A list-of-form-versions resource object.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/ListFormVersionsDataAttributes"
+        id:
+          description: The ID of the form.
+          example: 22f6006a-2302-4926-9396-d2dfcf7b0b34
+          type: string
+        type:
+          $ref: "#/components/schemas/FormVersionListType"
+      required:
+        - id
+        - type
+        - attributes
+      type: object
+    ListFormVersionsDataAttributes:
+      description: The attributes for a list of form versions.
+      properties:
+        versions:
+          description: The list of versions for the form.
+          items:
+            $ref: "#/components/schemas/FormVersionAttributes"
+          type: array
+      required:
+        - versions
+      type: object
+    ListFormVersionsResponse:
+      description: A response containing the list of versions for a form.
+      properties:
+        data:
+          $ref: "#/components/schemas/ListFormVersionsData"
+      required:
+        - data
+      type: object
     ListHistoricalJobsResponse:
       description: List of historical jobs.
       properties:
@@ -138604,6 +138652,71 @@ paths:
         **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/forms/{form_id}/versions:
+    get:
+      description: List all versions of a form.
+      operationId: ListFormVersions
+      parameters:
+        - description: The ID of the form.
+          example: 22f6006a-2302-4926-9396-d2dfcf7b0b34
+          in: path
+          name: form_id
+          required: true
+          schema:
+            format: uuid
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        versions:
+                          - created_at: "2026-05-29T20:06:14.895921Z"
+                            data_definition: {}
+                            definition_signature: '{"signature":"b7f312957a80cea2c8c9950532b205a90a3f8a7ebb7e52fc25437a25d903d545","version":1}'
+                            etag: b51f08b698d88d8027a935d9db649774949f5fb41a0c559bfee6a9a13225c72d
+                            has_ever_been_published: true
+                            id: "126"
+                            modified_at: "2026-05-29T20:06:14.949163Z"
+                            state: draft
+                            ui_definition: {}
+                            user_id: 10001
+                            user_uuid: 1fc709aa-be19-4539-a47d-52a30d78a978
+                            version: 2
+                      id: 22f6006a-2302-4926-9396-d2dfcf7b0b34
+                      type: form_version_lists
+              schema:
+                $ref: "#/components/schemas/ListFormVersionsResponse"
+          description: OK
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Bad Request
+        "401":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Unauthorized
+        "404":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Not Found
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      summary: List form versions
+      tags:
+        - Forms
+      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/).
     post:
       description: |-
         Create or update the latest draft version of a form. The `upsert_params` field controls
@@ -138686,6 +138799,84 @@ paths:
       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/forms/{form_id}/versions/revert:
+    post:
+      description: Revert a form to a prior version by creating a new draft version copied from it.
+      operationId: RevertFormVersion
+      parameters:
+        - description: The ID of the form.
+          example: 22f6006a-2302-4926-9396-d2dfcf7b0b34
+          in: path
+          name: form_id
+          required: true
+          schema:
+            format: uuid
+            type: string
+        - description: The version number to revert to.
+          example: 1
+          in: query
+          name: version
+          required: true
+          schema:
+            format: int64
+            type: integer
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        created_at: "2026-05-29T20:10:14.895921Z"
+                        data_definition:
+                          $ref: "#/components/schemas/FormDataDefinition"
+                        definition_signature: '{"signature":"c8f312957a80cea2c8c9950532b205a90a3f8a7ebb7e52fc25437a25d903d545","version":1}'
+                        etag: c61f08b698d88d8027a935d9db649774949f5fb41a0c559bfee6a9a13225c72d
+                        modified_at: "2026-05-29T20:10:14.949163Z"
+                        state: draft
+                        ui_definition: {}
+                        user_id: 10001
+                        user_uuid: 1fc709aa-be19-4539-a47d-52a30d78a978
+                        version: 3
+                      id: "127"
+                      type: form_versions
+              schema:
+                $ref: "#/components/schemas/FormVersionResponse"
+          description: OK
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Bad Request
+        "401":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Unauthorized
+        "404":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Not Found
+        "409":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Conflict
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      summary: Revert a form to a prior version
+      tags:
+        - Forms
+      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/forms/{form_id}/versions/upsert_and_publish:
     post:
       description: Upsert the latest form version and publish it in a single atomic transaction.

examples/v2/forms/ListFormVersions.ts

@@ -0,0 +1,22 @@
+/**
+ * List form versions returns "OK" response
+ */
+
+import { client, v2 } from "@datadog/datadog-api-client";
+
+const configuration = client.createConfiguration();
+configuration.unstableOperations["v2.listFormVersions"] = true;
+const apiInstance = new v2.FormsApi(configuration);
+
+const params: v2.FormsApiListFormVersionsRequest = {
+  formId: "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
+};
+
+apiInstance
+  .listFormVersions(params)
+  .then((data: v2.ListFormVersionsResponse) => {
+    console.log(
+      "API called successfully. Returned data: " + JSON.stringify(data)
+    );
+  })
+  .catch((error: any) => console.error(error));

examples/v2/forms/RevertFormVersion.ts

@@ -0,0 +1,23 @@
+/**
+ * Revert a form to a prior version returns "OK" response
+ */
+
+import { client, v2 } from "@datadog/datadog-api-client";
+
+const configuration = client.createConfiguration();
+configuration.unstableOperations["v2.revertFormVersion"] = true;
+const apiInstance = new v2.FormsApi(configuration);
+
+const params: v2.FormsApiRevertFormVersionRequest = {
+  formId: "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
+  version: 9223372036854775807,
+};
+
+apiInstance
+  .revertFormVersion(params)
+  .then((data: v2.FormVersionResponse) => {
+    console.log(
+      "API called successfully. Returned data: " + JSON.stringify(data)
+    );
+  })
+  .catch((error: any) => console.error(error));

features/support/scenarios_model_mapping.ts

@@ -9554,6 +9554,13 @@ export const ScenariosModelMappings: {[key: string]: {[key: string]: any}} = {
             },
         "operationResponseType": "FormPublicationResponse",
     },
+    "v2.ListFormVersions": {
+        "formId": {
+            "type": "string",
+            "format": "uuid",
+            },
+        "operationResponseType": "ListFormVersionsResponse",
+    },
     "v2.UpsertFormVersion": {
         "formId": {
             "type": "string",
@@ -9565,6 +9572,17 @@ export const ScenariosModelMappings: {[key: string]: {[key: string]: any}} = {
             },
         "operationResponseType": "FormVersionResponse",
     },
+    "v2.RevertFormVersion": {
+        "formId": {
+            "type": "string",
+            "format": "uuid",
+            },
+        "version": {
+            "type": "number",
+            "format": "int64",
+            },
+        "operationResponseType": "FormVersionResponse",
+    },
     "v2.UpsertAndPublishFormVersion": {
         "formId": {
             "type": "string",

features/v2/forms.feature

@@ -143,6 +143,30 @@ Feature: Forms
     And the response "data.type" is equal to "forms"
     And the response "data.attributes.name" is equal to "{{ unique }}"
 
+  @generated @skip @team:DataDog/app-builder-backend
+  Scenario: List form versions returns "Bad Request" response
+    Given operation "ListFormVersions" enabled
+    And new "ListFormVersions" request
+    And request contains "form_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/app-builder-backend
+  Scenario: List form versions returns "Not Found" response
+    Given operation "ListFormVersions" enabled
+    And new "ListFormVersions" request
+    And request contains "form_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 404 Not Found
+
+  @generated @skip @team:DataDog/app-builder-backend
+  Scenario: List form versions returns "OK" response
+    Given operation "ListFormVersions" enabled
+    And new "ListFormVersions" request
+    And request contains "form_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK
+
   @generated @skip @team:DataDog/app-builder-backend
   Scenario: List forms returns "Bad Request" response
     Given operation "ListForms" enabled
@@ -189,6 +213,42 @@ Feature: Forms
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/app-builder-backend
+  Scenario: Revert a form to a prior version returns "Bad Request" response
+    Given operation "RevertFormVersion" enabled
+    And new "RevertFormVersion" request
+    And request contains "form_id" parameter from "REPLACE.ME"
+    And request contains "version" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/app-builder-backend
+  Scenario: Revert a form to a prior version returns "Conflict" response
+    Given operation "RevertFormVersion" enabled
+    And new "RevertFormVersion" request
+    And request contains "form_id" parameter from "REPLACE.ME"
+    And request contains "version" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 409 Conflict
+
+  @generated @skip @team:DataDog/app-builder-backend
+  Scenario: Revert a form to a prior version returns "Not Found" response
+    Given operation "RevertFormVersion" enabled
+    And new "RevertFormVersion" request
+    And request contains "form_id" parameter from "REPLACE.ME"
+    And request contains "version" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 404 Not Found
+
+  @generated @skip @team:DataDog/app-builder-backend
+  Scenario: Revert a form to a prior version returns "OK" response
+    Given operation "RevertFormVersion" enabled
+    And new "RevertFormVersion" request
+    And request contains "form_id" parameter from "REPLACE.ME"
+    And request contains "version" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK
+
   @generated @skip @team:DataDog/app-builder-backend
   Scenario: Update a form returns "Bad Request" response
     Given operation "UpdateForm" enabled