Update an existing partner administrator.

All fields are optional. Only provided fields are updated.
For partnerSiteManager, locationIds can be updated to change managed locations.

Changing email to an address on an AMPECO domain (ampeco.com, ampeco.global, ampeco.tech) is refused with a 422 validation error: "Email addresses on AMPECO domains can only be assigned by AMPECO staff." An administrator whose current address is already on an AMPECO domain can keep it.

roleId must be a role the API token's administrator can give under the admin panel role hierarchy: a role below their own, a role at their own level only when their role has the "Manage admins at their own level" permission, and never a role excluded for their role. Any other roleId is refused with a 422 validation error: "The selected roleId is invalid."
The administrator's current roleId is always accepted. An administrator editing their own account may not change roleId, unless the request uses a Tenant admin API token.

An administrator at the same level as the API token's administrator returns 403 Forbidden when the token's role lacks the "Manage admins at their own level" permission, whatever fields are sent, and nothing changes.

This behaviour changed in place, without a new API version.

Required permission: Admins.update