Additional Forms v2 API endpoints

config/_default/menus/api.en.yaml

@@ -11844,6 +11844,71 @@ menu:
       url: /api/latest/forms/
       identifier: forms
       generated: true
+    - name: Upsert and publish a form version
+      url: /api/latest/forms/upsert-and-publish-a-form-version/
+      identifier: forms-upsert-and-publish-a-form-version
+      parent: forms
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - UpsertAndPublishFormVersion
+        unstable:
+          - v2
+        order: 10
+    - name: Create or update a form version
+      url: /api/latest/forms/create-or-update-a-form-version/
+      identifier: forms-create-or-update-a-form-version
+      parent: forms
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - UpsertFormVersion
+        unstable:
+          - v2
+        order: 7
+    - name: Publish a form version
+      url: /api/latest/forms/publish-a-form-version/
+      identifier: forms-publish-a-form-version
+      parent: forms
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - PublishForm
+        unstable:
+          - v2
+        order: 8
+    - name: Clone a form
+      url: /api/latest/forms/clone-a-form/
+      identifier: forms-clone-a-form
+      parent: forms
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - CloneForm
+        unstable:
+          - v2
+        order: 9
+    - name: Update a form
+      url: /api/latest/forms/update-a-form/
+      identifier: forms-update-a-form
+      parent: forms
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - UpdateForm
+        unstable:
+          - v2
+        order: 6
     - name: Get a form
       url: /api/latest/forms/get-a-form/
       identifier: forms-get-a-form

content/en/api/latest/forms/clone-a-form/index.md

@@ -0,0 +1,3 @@
+---
+title: Clone a form
+---

content/en/api/latest/forms/create-or-update-a-form-version/index.md

@@ -0,0 +1,3 @@
+---
+title: Create or update a form version
+---

content/en/api/latest/forms/publish-a-form-version/index.md

@@ -0,0 +1,3 @@
+---
+title: Publish a form version
+---

content/en/api/latest/forms/update-a-form/index.md

@@ -0,0 +1,3 @@
+---
+title: Update a form
+---

content/en/api/latest/forms/upsert-and-publish-a-form-version/index.md

@@ -0,0 +1,3 @@
+---
+title: Upsert and publish a form version
+---

content/en/api/v2/forms/request.PublishForm.json

@@ -0,0 +1,8 @@
+{
+  "data": {
+    "attributes": {
+      "version": 1
+    },
+    "type": "form_publications"
+  }
+}

content/en/api/v2/forms/request.UpdateForm.json

@@ -0,0 +1,17 @@
+{
+  "data": {
+    "attributes": {
+      "form_update": {
+        "datastore_config": {
+          "datastore_id": "5108ea24-dd83-4696-9caa-f069f73d0fad",
+          "primary_column_name": "id",
+          "primary_key_generation_strategy": "none"
+        },
+        "description": "An updated description.",
+        "name": "Updated Form Name"
+      }
+    },
+    "id": "22f6006a-2302-4926-9396-d2dfcf7b0b34",
+    "type": "forms"
+  }
+}

content/en/api/v2/forms/request.UpsertAndPublishFormVersion.json

@@ -0,0 +1,22 @@
+{
+  "data": {
+    "attributes": {
+      "data_definition": {
+        "description": "Welcome to the Engineering Experience Survey.",
+        "required": [],
+        "title": "Developer Experience Survey",
+        "type": "object"
+      },
+      "ui_definition": {
+        "ui:order": [],
+        "ui:theme": {
+          "primaryColor": "gray"
+        }
+      },
+      "upsert_params": {
+        "etag": "b51f08b698d88d8027a935d9db649774949f5fb41a0c559bfee6a9a13225c72d"
+      }
+    },
+    "type": "form_versions"
+  }
+}

content/en/api/v2/forms/request.UpsertFormVersion.json

@@ -0,0 +1,25 @@
+{
+  "data": {
+    "attributes": {
+      "data_definition": {
+        "description": "Welcome to the Engineering Experience Survey.",
+        "required": [],
+        "title": "Developer Experience Survey",
+        "type": "object"
+      },
+      "state": "frozen",
+      "ui_definition": {
+        "ui:order": [],
+        "ui:theme": {
+          "primaryColor": "gray"
+        }
+      },
+      "upsert_params": {
+        "etag": "b51f08b698d88d8027a935d9db649774949f5fb41a0c559bfee6a9a13225c72d",
+        "insert_only": false,
+        "match_policy": "none"
+      }
+    },
+    "type": "form_versions"
+  }
+}

data/api/v2/CodeExamples.json

@@ -814,6 +814,34 @@
       "description": "Create and publish a form returns \"OK\" response"
     }
   ],
+  "UpsertFormVersion": [
+    {
+      "group": "forms",
+      "suffix": "",
+      "description": "Create or update a form version returns \"OK\" response"
+    }
+  ],
+  "PublishForm": [
+    {
+      "group": "forms",
+      "suffix": "",
+      "description": "Publish a form version returns \"OK\" response"
+    }
+  ],
+  "UpdateForm": [
+    {
+      "group": "forms",
+      "suffix": "",
+      "description": "Update a form returns \"OK\" response"
+    }
+  ],
+  "UpsertAndPublishFormVersion": [
+    {
+      "group": "forms",
+      "suffix": "",
+      "description": "Upsert and publish a form version returns \"OK\" response"
+    }
+  ],
   "MakeGCPSTSDelegate": [
     {
       "group": "gcp_integration",