Shareable Media Files (Partial Update)
Description
Patches Media File Resources synchronously. Does not handle partial successes or failures if multiple are provided.
See the Aerial Spec for more details.
File Naming Convention
TGEN_shareableMediaFiles_partialupdate_2026-08_<optionalSuffix>.csv
importType:partialupdateapiVersion: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. You may omit any non-required fields from the sample CSV, reference the table above for required fields.