19 August 2024
Production release: 19 August 2024
Staging release: 12 August 2024
19 August 2024
Section titled “19 August 2024”Feature Improvements:
Section titled “Feature Improvements:”Support Files
Section titled “Support Files”Definition
Section titled “Definition”Support files are supplementary files linked to a parent file, such as a thumbnail image linked to an image file.
Uploading
Section titled “Uploading”Uploading a support file is similar to a regular file, but requires setting parentId and parentType (set to FILE).
Linking
Section titled “Linking”By default, linked to the latest parent file version using the support file’s name as the key. Can specify a parent version using parentMajorVersion and supportFileKey.
ACL Permissions
Section titled “ACL Permissions”Inherited from the parent file; cannot be set or updated independently.
Constraints
Section titled “Constraints”- Operations like move, delete, and restore are not allowed.
- Custom metadata updates, copy, and rename operations are permitted.
- Deleting/restoring the parent file also deletes/restores its support files.
File Link Constraints
Section titled “File Link Constraints”- Maximum of 10 support files per parent file.
- Links are not automatically carried over to new parent file versions unless copyLinks is set to true.
- Renaming a support file does not change the link key.
- Only the parent file can establish links.
Versioning and Linking
Section titled “Versioning and Linking”- Changes in links increment the parent file’s minor or metadata version.
- To retrieve latest links for a specific version, use version-specific endpoints.
- New major versions with copyLinks set to true carry over links, resulting in a single support file linked to multiple main file versions.