https://api.us.nylas.com/v3/iam/principals/{principal_id}Update IAM principal
Updates a principal.
Each field you send replaces its current value, and fields you leave out stay the same. An empty roles or direct_permissions array removes all of them. An empty description removes the description. resource_binding replaces the principal's binding.
Nylas rejects empty bodies, null values, unknown fields, and add or remove payloads.
If the principal has active API keys, a binding other than Organization must resolve to exactly one application. A change that breaks this rule returns 409. You can't delete, disable, or remove the binding or role from the last active Organization-bound IAM Admin.
Requires an IAM API key with the iam.principals.update permission. Application API keys and access tokens don't work.
nameA name for the principal, such as the service that uses it. Nylas trims leading and trailing spaces.
direct_permissionsUp to 100 permission IDs assigned directly to the principal. Nylas removes duplicates. See the permissions reference.