Updates an Identity entity.

Each field has its own validation rules. Below are some notable behaviors to be aware of:

• managementType — Automatically determined based on the primary email domain and the organization's registered domains. Even if managed is specified, the actual value may be recategorized (e.g. external, system) depending on the email domain.
• employeeType — Must be compatible with the resolved managementType. If an incompatible type is provided, a default will be assigned.
• primaryEmail / secondaryEmails — Swapping values between primary and secondary emails will reorder them. If the current primary email is linked to a SaaS account, the old primary must be preserved in secondaryEmails.
• employeeId — Must be unique within the organization.

Note: Additional system-level validations exist beyond those listed above. Refer to the error responses for details.