|API Support||Available since||Last updated||Output|
Edit the account details of a member.
Both the firstname and surname are limited to 50 characters.
The member-username must be less than 100 characters, unique and cannot contain a '@'. The username is required unless the an email address is specified.
The email must be less than 100 characters, unique and be a valid Email address. The email address is required unless a username is specified.
If the email is changed and force-email-change is not true, then the email will not be changed but a confirmation message will be sent to the new email address.
The member details are only modified if they are specified in the request.
The member-password must be less than 100 characters. When the password is not specified, the member's email will be used if no confirmation is needed, otherwise, a new password will be generated.
Passwords must satisfy a given strength check to be accepted:
- Regular members must have at least a MEDIUM strength.
- Administrators must use a STRONG password.
Users MUST include their current password using current-password in order to be able to change their password.
By default, an email is sent to the user when their password is changed unless member status is
set-password (i.e. the member is setting up their account). To override this behavior, set password-email to "
This service will use the default PageSeeder templates.
To use customized emails, use the
customFolder template property.
|current-password||The member's current password (required by non-administrator if a new password is specified).||maybe||string|
|The member's email address.||no|
|email-attachments||Set to "|
Set to "
|firstname||The member's first name. Max 50 characters.||no||string|
|force-email-change||Set to "||no||boolean|
|member-password||The member's new password.||no||string|
|member-username||The member's username.||no||string|
|on-vacation||Set to "||no||boolean|
|password-email||Set to "||no||boolean|
|surname||The member's last name. Max 50 characters.||no||string|
|token||The account activation token.||yes, if not authenticated||string|
|notify-async||Whether emails should be sent asynchronously (for slow email servers).||no||boolean|
This service can only be invoked by the user herself or an Administrator.
Only administrators can change a password without having to submit the current password.
The XML returned is always:
<member-modification> <member id="[member id]" firstname="[first name]" surname="[surname]" username="[username]" status="[activated|unactivated]"> <fullname>[full name]</fullname> </member> </member-modification>
|Code||Cause / Description|
|0x1001||If the username contains the character '@'.".|
|0x1002||If the email address is invalid.|
|0x1004||If the username or email are already in use.|
|0x1007||If the first name or surname is longer than 50 characters|
|0x1009||If the username is too long|
|0x100A||If the email address is longer then 100 characters|
|0x100B||If the new password is too long|
|0x100C||If the current password is not specified|
|0x1015||If the new password is too weak|
|0x1017||If the current password is incorrect|
|0x6002||If the email change notification could not be sent|
|0x6003||If the password change notification could not be sent|
Created on , last edited on