Skip to main content

 Services

Web services from /about to /webhooks

membership

/groups/{group}/members/{member} [PATCH]

Description

Edit the details of a member and its membership for a specific group.

Member details

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 email must be less than 100 characters, unique and be a valid Email address.

Password details

The member-password must be less than 100 characters.

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.

Group membership parameters

The notification parameter must be one of immediate, essential, daily, weekly or none. Users are able to subsequently change this setting through the user interface in their group registration options.

The role parameter must be one of guest, reviewer, contributor, manager, approver, moderator-and-approver, moderator.

The listed boolean parameter can be used to override the group’s default setting. It affects whether other group member are able to see the member’s user details. Users are able to subsequently change this setting through the user interface in their group registration options.

Additional information specific to the group can also be attached to the user using the details fields field1 to field15

This service can be used to deregister a member from a group by setting the deregister parameter to true.

Parameters

There are no required parameters for this service, but parameters that are specified modify the member accordingly.

NameDescriptionRequiredTypeDefault
current-passwordThe member’s current password (required by non-administrator if a new password is specified)maybestring
acceptWhether to accept an invitation to the groupnobooleanfalse
deregisterWhether to remove the member from the groupnobooleanfalse
emailThe member’s email addressnoemail
field1Custom field #1no string
field10Custom field #10nostring 
field11Custom field #11nostring 
field12Custom field #12nostring 
field13Custom field #13nostring 
field14Custom field #14nostring 
field15Custom field #15nostring 
field2Custom field #2nostring
field3Custom field #3nostring 
field4Custom field #4nostring 
field5Custom field #5nostring 
field6Custom field #6nostring 
field7Custom field #7nostring 
field8Custom field #8nostring 
field9Custom field #9nostring 
firstnameThe member’s given/other namenostring
force-email-changeSet to true to change the email address without notification (administrator only)nobooleanfalse
listedWhether the member’s email address is listed in the groupnoboolean
member-passwordThe member’s passwordnostring
member-usernameThe member’s username, defaults to the member’s email addressnostring
notificationThe member’s notification option in the groupnoenum
password-emailSet to false to change the password without notification (adminstrator only)nobooleantrue
roleThe member’s role in the group (administrators only)noenum
surnameThe member’s family nameno string
welcome-emailWhether to send a group welcome email to the membernobooleantrue
notify-asyncWhether emails should be sent asynchronously (for slow email servers)nobooleanfalse

notification

The notification can be none, immediate or daily.

Permission

The member on the request or an administrator can invoke this service.

Response

When successful, the XML returned the full details of the updated membership as a <membership> element wrapped in a <membership-modification> element.

<membership-modification>
  <membership id="[membershipid]" 
              email-listed="[true|false]" 
              notification="[none|
                             essential|
                             immediate|
                             daily|
                             weekly]"
              [status="[status]"]
              [role="[role]"]>
    <member id="[member id]"
            firstname="[first name]"
            surname="[surname]"
            username="[username]"
            email="[email]"
            status="[activated|unactivated|set-password]">
      <fullname>[full name]</fullname>
    </member>
    <group id="[group id]" 
           name="[name]" 
           visibility="[visibility]" 
           template="[template]">
      <description>[description]</description>
    </group>
  </membership>
</membership-modification>

Error Handling

CodeCause / Description
0x1001If the username is invalid
0x1002If the email address is invalid
0x1004If the specified username or email is already in use by another user
0x1006If the member is not a member of the group
0x1007If the first name or surname is longer than 20 characters
0x1008If the user or email is not specified
0x1009If the username is too long
0x100AIf the email address is longer then 100 characters
0x100BIf the password is too long
0x1015If the password is too weak
0x1017If the current password is incorrect
0x1026If the member has not been invited to the group
0x6003If the password change notification could not be sent
0x6004If the member details have not been configured properly
Created on , last edited on