Tally.so

Interact with Tally.so forms and submissions

Actions10

Form → Delete Field

AI-generated

Overview

This node operation deletes one or more fields (questions) from a specified Tally.so form. It supports selecting fields to delete either by their UUIDs or by their exact labels. The operation fetches the current form and its questions, clones the form's blocks, removes the specified fields, and then updates the form with the modified blocks. It also supports a dry-run mode to preview changes without applying them, backing up the previous form state for rollback, and optimistic concurrency control to prevent overwriting changes made by others.

Use Case Examples

  1. Deleting a single field by UUID from a form to remove an outdated question.
  2. Deleting multiple fields by their labels to clean up a form before publishing.
  3. Using dry-run mode to preview which fields will be deleted before applying changes.

Properties

Name Meaning
Form Target form to update, selected from available forms.
Select By Method to select fields to delete, either by UUID or by Label.
Field UUID UUID of a single field to delete, used when selecting by UUID.
Field Label Exact label of a single field to delete, used when selecting by Label.
Field UUIDs Multiple UUIDs of fields to delete, used when selecting by UUID.
Field Labels Multiple labels of fields to delete, used when selecting by Label.
Dry-Run / Preview If enabled, the node does not apply changes but outputs the proposed blocks and a diff for review.
Backup Previous Form If enabled, includes the pre-patch form JSON in the output to enable rollback later.
Optimistic Concurrency If enabled, compares the form's updatedAt timestamp before patching and aborts if it has changed to prevent overwrites.

Output

JSON

  • updated - Indicates if the form was successfully updated.
  • form - The updated form object after deletion of fields.
  • backup - The previous form JSON before the update, included if backup is enabled.
  • preview - Indicates if the output is a dry-run preview.
  • formId - The ID of the form being modified.
  • proposedBlocks - The proposed form blocks after deletion, shown in dry-run mode.
  • diff - The difference between the original and proposed form blocks, shown in dry-run mode.

Dependencies

  • Tally.so API with an API key credential

Troubleshooting

  • Error 'No matching fields were found to delete' occurs if the specified UUIDs or labels do not match any fields in the form. Verify the field identifiers are correct.
  • If the form has been updated by another process since it was read, an optimistic concurrency error will occur. Re-run the operation to get the latest form state before applying changes.
  • JSON parsing errors may occur if input fields like UUIDs or labels are malformed or incorrectly formatted.

Links

Discussion