File Versioning

All files ingested by the Tetra Data Platform (TDP) are versioned automatically. The Search API and user interface will only return the latest version by default, but 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 as well. Applying new custom metadata to an existing file will prompt a version change. When 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.