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-04_<optionalSuffix>.csv
importType:partialupdateapiVersion:2026-04
Columns
| 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 | array | No | |
variant.uuid[0] | Array element | string | No | |
variant.externalId | External ID of the resource | array | No | |
variant.externalId[0] | Array element | 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. | 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.