Tally.so

Interact with Tally.so forms and submissions

Form → Rollback Form

AI-generated

Overview

The Rollback Form operation in the Tally.so node allows users to revert a form to a previous state using a backup JSON of the form. This is useful for restoring a form after unwanted changes or errors. Users can provide the backup JSON directly or use the incoming item data. The operation supports a dry-run mode to preview changes and the actual rollback updates the form blocks via a PATCH request.

Use Case Examples

  1. Restoring a form to a previous version after accidental deletion of fields.
  2. Previewing the rollback changes before applying them to ensure correctness.

Properties

Name Meaning
Form The ID of the form to rollback to a previous state, selected from available forms.
Backup Form JSON The full form JSON backup to rollback to. If empty, the node uses incoming item JSON from $json.backup, $json.form, or $json.
Dry-Run / Preview If enabled, the node does not perform the PATCH update but outputs the proposed blocks and a diff for preview.

Output

JSON

  • updated - Indicates the form was successfully updated.
  • form - The updated form object after rollback.

Dependencies

  • An API key credential for Tally.so API access

Troubleshooting

  • Error if no valid form JSON is found in the backup or incoming data; ensure the backup JSON is correctly provided or passed from previous nodes.
  • Conflict error if the form has changed since it was read before rollback; retry the operation to avoid overwrites.

Links

Discussion