Create Form Version

Create a new version of an existing form for updates.

Use Cases:

• Update a published form without breaking the live version
• Test changes before deploying to production
• Create A/B test variants
• Roll back to previous versions
• Maintain form version history

Behavior:

• New version inherits all fields from parent if not provided
• Created in DRAFT status (can be edited)
• Parent can be root form or any existing version
• Only one DRAFT version allowed per root form
• All fields are optional (defaults to parent values)
• New version gets unique ID but shares root form lineage

Required Scope: write:forms

Version Inheritance:

• If no fields provided, copies all from parent
• Specify only fields you want to change
• Omitted fields default to parent values
• Creates independent copy (changes don't affect parent)

Versioning Workflow:

1. Published form is live on website
2. Create new version (inherits configuration)
3. Modify new DRAFT version as needed
4. Test new version
5. Publish new version
6. Previous published version becomes ARCHIVED
7. Form URL remains constant across versions

Important:

• Cannot create version if DRAFT already exists for this root form
• Only one DRAFT version per form family
• Publish or delete existing DRAFT before creating new version
• Versions share the same root form ID

Note: This enables zero-downtime form updates - edit in draft, test, then publish when ready.