Roles (Full Update)
Description
Upsert Role Resource
See the Aerial Spec for more details.
File Naming Convention
TGEN_roles_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 |
|---|---|---|---|---|
externalId | External ID of the role | Max Length: 255 | string | Yes |
name | Name of the role | Max Length: 255 | string | Yes |
description | Description of the role | Max Length: 255 | string | No |
owner | Owner of the role: which system is responsible for managing user assignment with this role. When there is no owner, all related systems may perform role assignment. | Allowed: admin-console, api-integration, scim | string | No |
Sample CSV
See the following roles 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.