Variant Serial Numbers (Partial Update)
Description
Creates or updates serial numbers for a variant identified by the variant field in the request body.
Add vs. replace behavior
By default, the provided serial numbers are appended to the variant's existing serial numbers.
To replace all existing serial numbers, include the literal string "SET_AS_NULL"
as one of the entries in the serialNumbers array. This triggers a full replacement: all existing
serial numbers are removed and only the non-SET_AS_NULL entries in the array are saved.
See the Aerial Spec for more details.
File Naming Convention
TGEN_variantSerialNumbers_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 |
|---|---|---|---|---|
variant | UUID or external ID of a variant associated with this resource. | string | No | |
variant.uuid | UUID of the resource | string | No | |
variant.externalId | External ID of the resource | string | No | |
serialNumbers | A collection of Serial numbers of the variant that can be expressed using “SET_AS_NULL” (to reset all existing values) or a value as defined in its types. | Not a CSV column header. Pass each array element in its own indexed column (serialNumbers[0], serialNumbers[1], and so on). | array | No |
serialNumbers[0] | Array element | mixed | No | |
serialNumbers[0].value | The serial number that can be expressed using a value as defined in its types. | string | No |
Sample CSV
See the following variantSerialNumbers 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.