Shareable Media Files (Full Update)
Description
See the Aerial Spec for more details.
File Naming Convention
TGEN_shareableMediaFiles_fullupdate_2026-08_<optionalSuffix>.csv
importType:fullupdateapiVersion:2026-08
Columns
Nested object fields are flattened into columns using dot notation (parent.child). Array fields are flattened using zero-based index notation, one element per column (field[0], field[1], and so on).
Note: A whole array cannot be passed in a single column: a literal value such as ['value-1','value-2'] will be rejected. To import multiple array elements, add one indexed column per element. Rows in the table below with type array describe the field as a whole and are not valid CSV column headers.
| Column Header | Description | Key Information | Type | Required |
|---|---|---|---|---|
assetId | Mux Asset identifier of the media file | Max Length: 255 | string | No |
hash | Content hash of the media file, as supplied by the uploader | Max Length: 32 | string | No |
displayName | The display name or title of the media file | Max Length: 50 | string | No |
type | MIME type of the media file, e.g. image/png, video/mp4 or application/pdf | Max Length: 50 | string | No |
thumbnailUrl | URL of where the thumbnail is hosted | Max Length: 150 | string | No |
mediaUrl | URL of where the media is hosted | Max Length: 150 | string | No |
metadata | Metadata of the shareable media | Max Length: 255 | string | No |
isShareable | Boolean dictating if media is shareable | boolean | No | |
isHidden | Boolean dictating if media is hidden | boolean | No | |
isReadOnly | Boolean dictating if media is readonly | boolean | No | |
isDeleted | Boolean dictating if media is deleted | boolean | No | |
associations | Categories this file belongs to. Send a category UUID, or an object to name the category by external ID or scope the association to a store or associate. Responses list category UUIDs. | Not a CSV column header. Pass each array element in its own indexed column (associations[0], associations[1], and so on). | array | No |
associations[0] | Array element | mixed | No |
Sample CSV
See the following shareableMediaFiles CSV sample file.
Note: The sample CSV may contain sample ID fields which reference other resources that do not match the data in your environment.