|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 "false".
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||no|
|email-attachments||"true" to include attachments to email notifications, "false" to include links to PageSeeder instead||no||boolean|
|firstname||The member's first name. Max 50 characters.||no||string|
|force-email-change||Set to "true" to change the email address without notification (administrator only)||no||boolean|
|member-password||The member's new password||no||string|
|member-username||The member's username||no||string|
|on-vacation||Set to "true" to suspend normal email notifications||no||boolean|
|password-email||Set to "false" to change the password without notification (adminstrator only)||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 to send emails 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