v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Forms

Create or update a form version

Create or update the latest draft version of a form. The upsert_params field controls optimistic concurrency behavior.

post/api/v2/forms/{form_id}/versions

Path parameters

form_idstring uuid required

The ID of the form.

Request body

Example request

{
  "data": {
    "attributes": {
      "data_definition": {
        "description": "Welcome to the Engineering Experience Survey.",
        "title": "Developer Experience Survey"
      },
      "state": "frozen",
      "upsert_params": {
        "etag": "b51f08b698d88d8027a935d9db649774949f5fb41a0c559bfee6a9a13225c72d",
        "match_policy": "none"
      }
    },
    "type": "form_versions"
  }
}

Response

Example response

{
  "data": {
    "attributes": {
      "created_at": "2026-05-29T20:06:14.895921Z",
      "data_definition": {
        "description": "Welcome to the Engineering Experience Survey.",
        "title": "Developer Experience Survey"
      },
      "definition_signature": "{\"signature\":\"b7f312957a80cea2c8c9950532b205a90a3f8a7ebb7e52fc25437a25d903d545\",\"version\":1}",
      "etag": "b51f08b698d88d8027a935d9db649774949f5fb41a0c559bfee6a9a13225c72d",
      "id": "126",
      "modified_at": "2026-05-29T20:06:14.949163Z",
      "state": "frozen",
      "user_id": 10001,
      "user_uuid": "1fc709aa-be19-4539-a47d-52a30d78a978",
      "version": 1
    },
    "id": "126",
    "type": "form_versions"
  }
}