Users (Partial Update)
Description
Patch User Resources.
If the UUID of the User exists in the system, or no UUID is provided and an External ID exists, then an update is performed on the provided fields. Note: to clear field set value to string SET_AS_NULL
See the Aerial Spec for more details.
File Naming Convention
TGEN_users_partialupdate_2026-04_<optionalSuffix>.csv
importType:partialupdateapiVersion:2026-04
Columns
| Column Header | Description | Key Information | Type | Required |
|---|---|---|---|---|
username | The username of the employee | string | Yes | |
password | For standard integrations, this field is used exclusively to set a temporary password during user creation; the password field is ignored when updating existing users. Unless configured otherwise, temporary passwords must be at least 12 characters long and must include one letter, one number, and one special character. Legacy configurations support ongoing (and non-temporary) password updates. | string | No | |
disabled | Boolean dictating if user is disabled (true or false) | boolean | No | |
employee | Unique Tulip identifier of the employee | Max Length: 36 | string | No |
roles | Array of role external ID’s | array | No | |
roles[0] | Array element | string | No |
Sample CSV
See the following users 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.