Deleting a Dataset

(introduced: version 2026.1)

When a Dataset is deleted, it is soft-deleted and placed in the trash. After 30 days in the trash, the Dataset and all of its Entities will be automatically purged. Unlike Forms, deleted Datasets cannot be restored.

While in the trash, the Dataset's Entity data can still be exported as a CSV snapshot using GET /projects/:id/trash/datasets/:datasetId/entities.csv.

A Dataset cannot be deleted if any Forms are still linked to it, either as a source (a Form that creates/updates Entities in it) or as a consumer (a Form that uses it as an attachment). All such Forms must be updated first:

• To update a Form that writes to a Dataset, remove that dataset from the entities tab of the XLSForm and remove associated save_tos.
• To update a Form that reads from a Dataset, replace the attachment with a static CSV or update the Form to not use that attachment.

A Form can also be deleted as a way to unlink it from a Dataset, but then that Form cannot be restored.