List Form Versions

Retrieve all versions of a specific form.

Use Cases:

• View version history of a form
• List all versions for rollback selection
• Audit form changes over time
• Display version information in admin dashboard
• Compare versions before rollback

Behavior:

• Returns all versions for the specified root form
• Includes the root form itself (version 1)
• Versions are ordered by version number (ascending)
• Only works with root form IDs (parentId must be null)
• Returns error if formId is a version (not root form)
• Returns all statuses (DRAFT, PUBLISHED, ARCHIVED)

Required Scope: read:forms

Response Fields:

• id: Unique version identifier
• name: Form name
• description: Form description (optional)
• status: DRAFT, PUBLISHED, or ARCHIVED
• version: Version number (1, 2, 3, etc.)

Version Status:

• DRAFT: Can be edited, not published yet
• PUBLISHED: Currently live version
• ARCHIVED: Previous published version

Note: To get a specific form/version with full details including fields, use GET /v1/forms/{formId}