File Versioning

All files ingested by the TetraScience Data Platform (TDP) are versioned automatically. By default, the search API will only return the latest version; however, all historical files are automatically preserved. By hiding the older versions, this allows for a more seamless search experience and prevents confusion around seemingly duplicate files.

Custom Metadata and Tags

Custom metadata and tags are treated as part of the file and are automatically versioned. You can apply new custom metadata to an existing file without creating a new version. When a new file version is uploaded, metadata and tags are not copied from the previous version and should be provided within the upload request.

This design choice allows significantly more sophisticated workflows and business logic (such as quality review and validation) while reducing ambiguity. Versioning file metadata allows for the most thorough and accurate historical representation of the data and associated business actions.