YM REST Services

Groups

**Requires Authentication**
Requires any of the roles:	admin, oauthadmin

The following routes are available for this service:
GET	/Ams/{ClientID}/Groups	Return a list of Groups for a Client.
POST	/Ams/{ClientID}/Groups	Create a Group and return the newly created GroupID.
PUT	/Ams/{ClientID}/Groups	Update an existing Group.	Omitted fields will be ignored.

**Groups** Parameters:
Name	Parameter	Data Type	Required
GroupID	body	int?	No
GroupCode	body	string	No
TypeID	body	int?	No
Name	body	string	No
Active	body	bool?	No
Hidden	body	bool?	No
Accessibility	body	int?	No
Membership	body	int?	No
Messaging	body	int?	No
SendNewsletter	body	bool?	No
EnableFeed	body	bool?	No
AdminCanExportMembers	body	bool?	No
PhotoApproval	body	bool?	No
EmailOptionsAdmin	body	int?	No
EmailOptionsMember	body	int?	No
ShortDescription	body	string	No
WelcomeContent	body	string	No

**BaseDto** Parameters:
Name	Parameter	Data Type	Required
UsingRedis	form	bool	No
AppInitTime	form	DateTime	No
ServerID	form	string	No

**BaseSharedDto** Parameters:
Name	Parameter	Data Type	Required
ClientID	form	int	No
ResponseStatus	form	ResponseStatus	No
BypassCache	form	bool	No
DateCached	form	DateTime	No
Device	form	Device	No

**GroupsResponse** Parameters:
Name	Parameter	Data Type	Required	Description
GroupTypeList	form	List<GroupType>	No

**GroupType** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
TypeName	form	string	No
SortIndex	form	double?	No
Groups	form	List<Group>	No

**Group** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Name	form	string	No
Status	form	Status?	No
JoinOption	form	JoinOption?	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /Ams/{ClientID}/Groups HTTP/1.1 
Host: ws.yourmembership.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<Groups xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/YM.Web.Services.Ams">
  <BypassCache xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">false</BypassCache>
  <ClientID xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">0</ClientID>
  <Device xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">Desktop</Device>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types" xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
  <Accessibility>0</Accessibility>
  <Active>false</Active>
  <AdminCanExportMembers>false</AdminCanExportMembers>
  <EmailOptionsAdmin>0</EmailOptionsAdmin>
  <EmailOptionsMember>0</EmailOptionsMember>
  <EnableFeed>false</EnableFeed>
  <GroupCode>String</GroupCode>
  <GroupID>0</GroupID>
  <Hidden>false</Hidden>
  <Membership>0</Membership>
  <Messaging>0</Messaging>
  <Name>String</Name>
  <PhotoApproval>false</PhotoApproval>
  <SendNewsletter>false</SendNewsletter>
  <ShortDescription>String</ShortDescription>
  <TypeID>0</TypeID>
  <WelcomeContent>String</WelcomeContent>
</Groups>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GroupsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/YM.Web.Services.Ams">
  <BypassCache xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">false</BypassCache>
  <ClientID xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">0</ClientID>
  <Device xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">Desktop</Device>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types" xmlns="http://schemas.datacontract.org/2004/07/YM.Toolkit">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
  <Accessibility>0</Accessibility>
  <Active>false</Active>
  <AdminCanExportMembers>false</AdminCanExportMembers>
  <EmailOptionsAdmin>0</EmailOptionsAdmin>
  <EmailOptionsMember>0</EmailOptionsMember>
  <EnableFeed>false</EnableFeed>
  <GroupCode>String</GroupCode>
  <GroupID>0</GroupID>
  <Hidden>false</Hidden>
  <Membership>0</Membership>
  <Messaging>0</Messaging>
  <Name>String</Name>
  <PhotoApproval>false</PhotoApproval>
  <SendNewsletter>false</SendNewsletter>
  <ShortDescription>String</ShortDescription>
  <TypeID>0</TypeID>
  <WelcomeContent>String</WelcomeContent>
  <GroupTypeList>
    <GroupType>
      <Groups>
        <Group>
          <Id>0</Id>
          <JoinOption>CanJoin</JoinOption>
          <Name>String</Name>
          <Status>None</Status>
        </Group>
      </Groups>
      <Id>0</Id>
      <SortIndex>0</SortIndex>
      <TypeName>String</TypeName>
    </GroupType>
  </GroupTypeList>
</GroupsResponse>