membership

Description

Returns the group details for a member.

Parameters

subgroups

This parameter is used as a flag to specify if subgroup membership is to be considered. The possible values are true and false and the default value is true.

Permission

Only the member herself or an administrator can invoke this service. If parameter role=manager then a manager of the group is also allowed.

Response

If the member belongs to the group, the membership is returned as <membership> element enclosing the <member>, <group>/<project> and if applicable the <details> elements.

<membership id="[membership id]" 
            email-listed="[true|false]"
            notification="[none|immediate|daily]" 
            flags="[flags]"
            status="[normal|
                    invited|
                    self-invited|
                    disabled]"
            role="[role]" 
            [subgroups="[subgroups]"]>
  <member id="[member id]" 
          firstname="[first name]" 
          surname="[surname]"
          username="[username]" 
          status="[activated|unactivated]">
    <fullname>[full name]</fullname>
  </member>
  <group|project id="[group id]"
                 name="[group name]"
                 description="[description]"
                 owner="[owner]"
                 [relatedurl="[url]"] />
  <details>
    <field position="1" 
           name="[field name]" 
           editable="[true|false]" 
           [title="[field title]"] 
           [type="[field type]"]>[field value]
    </field>
    ...
  </details>
</membership>
 

Error Handling