DELETE api/v3/addressbook/groups/{groupID}/contacts
This method removes multiple Contacts from a Group.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
groupID |
The ID of the Group that Contacts will be removed from. |
globally unique identifier |
Required |
Body Parameters
List of contacts (person numbers) to be removed from the Group.
TwoSms.CustomerPortalRole.API.AddressBooks.GroupMemberRequestName | Description | Type | Additional information |
---|---|---|---|
All |
Determines whether to add/remove all members in the address book depending on request type. |
boolean |
None. |
Contacts |
List of all the person numbers to add/remove. Depending on the request the following actions are perform with this list: 1) If the request is adding members to the group and the all flag is set to true, then any person numbers contained in this list will not be added. 2) If the request is removing members from a group and the all flag is set to true, then any person numbers contained in this will remain members of the group. |
Collection of integer |
None. |
Request Formats
application/json, text/json
{ "All": true, "Contacts": [ 1, 2 ] }
application/xml, text/xml
<GroupMemberRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <All>true</All> <Contacts> <int>1</int> <int>2</int> </Contacts> </GroupMemberRequest>
application/x-www-form-urlencoded
Response Information
Resource Description
TwoSms.CustomerPortalRole.API.Misc.ResponseOfSystem.ObjectName | Description | Type | Additional information |
---|---|---|---|
Error | TwoSms.CustomerPortalRole.API.Misc.Error |
None. |
|
ResponseData | TwoSms.CustomerPortalRole.API.Misc.ResponseDataOfSystem.Object |
None. |
Response Formats
application/json, text/json
{ "Error": { "ErrorCode": "sample string 1", "ErrorReason": "sample string 2" }, "ResponseData": { "Identification": { "UserId": "sample string 1" }, "Result": "sample string 1", "Detail": {} } }
application/xml, text/xml
<ResponseOfObject xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Error> <ErrorCode>sample string 1</ErrorCode> <ErrorReason>sample string 2</ErrorReason> </Error> <ResponseData> <Result>sample string 1</Result> <Identification> <UserId>sample string 1</UserId> </Identification> <Detail /> </ResponseData> </ResponseOfObject>