msnp-wiki/docs/services/sharingservice/deletemember.md

# Introduction
`DeleteMember` is one of the SOAP actions the [Contact Sharing Service](../sharingservice.md) provides.

Deletes a user from the Allow List (AL), Block List (BL), or the Pending List (PL).

# Client/Request
The template used in this action is described on the [Address Book Service](../abservice.md) main page.

## DeleteMember
This element has only one attribute:
* `xmlns:` Is always set to `http://www.msn.com/webservices/AddressBook`.

### serviceHandle
This element contains three children:
* `<Id>`: This is always set to `0`.
* `<Type>`: The type of this member:
	* `Messenger`: This is a Messenger contact.
	* `Profile`: This is your profile.
* `<ForeignId>`: If `<Type>` is `Profile`, this should be `MyProfile`,
  otherwise leave empty but do not convert to an empty element.

### memberships
This element only contains `<Membership>` elements.

#### Membership
This element contains two children:
* `<MemberRole>`: The type of list:
	* `Allow`: The Allow List (AL).
	* `Block`: The Block List (BL).
	* `Pending`: The Pending List (RL).
	* `ProfileExpression`: Your profile.
* `<Members>`: Explained below.

##### Members
This element only contains `<Member>` elements.

###### Member
This element has two attributes:
* `xsi:type`: The type of this `<Member>`:
	* `PassportMember`
	* `EmailMember`
	* `PhoneMember`
	* `RoleMember`: Only valid for `ProfileExpression`.
* `xmlns:xsi`: This is always set to `http://www.w3.org/2001/XMLSchema-instance`.

This element contains three children:
* `<Type>`: The type of this `<Member>`:
	* `Passport`
	* `Email`
	* `Phone`
* `<MembershipId>`: The ID of the membership you would like to delete.
* `<State>`: This is usually only set to `Accepted`, but `Pending` is a valid value.
* `<Deleted>`: Should this member be deleted? (Only set to `true` in `UpdateMember`?)

This element may instead contain one of the following mutually exclusive children instead of `<MembershipId>`:
1. `<PassportName>`: The user handle associated with this membership.
2. `<Email>`: The e-mail address associated with this membership.
3. `<PhoneNumber>`: The phone number associated with this membership.

This element also contains the following children IF the role is set to `ProfileExpression`:
* `<Id>`: Always `Allow`.
* `<DefiningService>`: Contains the following:
	* `<Id>`: Always `0`.
	* `<Type>`: Always `Messenger`.
	* `<ForeignId>`: Always empty content, but not an empty element.
* `<MaxRoleRecursionDepth>`: Always `0`.
* `<MaxDegreesSeparationDepth>`: Always `0`.

# Server/Response
The template used in this action is described on the [Address Book Service](../abservice.md) main page.

## DeleteMemberResponse
This empty element has only one attribute:
* `xmlns:` Is always set to `http://www.msn.com/webservices/AddressBook`.

# Examples

## Client/Request
```
POST /abservice/SharingService.asmx HTTP/1.1
SOAPAction: http://www.msn.com/webservices/AddressBook/DeleteMember
Cache-Control: no-cache
Content-Type: text/xml; charset=utf-8
Content-Length: 1435

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
		xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		xmlns:xsd="http://www.w3.org/2001/XMLSchema"
		xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
>
		<soap:Header>
				<ABApplicationHeader
						xmlns="http://www.msn.com/webservices/AddressBook"
				>
						<ApplicationID>996CDE1E-AA53-4477-B943-2BE802EA6166</ApplicationID>
						<IsMigration>false</IsMigration>
						<PartnerScenario>Timer</PartnerScenario>
				</ABApplicationHeader>
				<ABAuthHeader
						xmlns="http://www.msn.com/webservices/AddressBook"
				>
						<ManagedGroupRequest>false</ManagedGroupRequest>
						<TicketToken>t=ticket&amp;p=profile</TicketToken>
				</ABAuthHeader>
		</soap:Header>
		<soap:Body>
				<DeleteMember
						xmlns="http://www.msn.com/webservices/AddressBook"
				>
						<serviceHandle>
								<Id>0</Id>
								<Id>Messenger</Id>
								<ForeignId></ForeignId>
						</serviceHandle>
						<memberships>
							<Membership>
								<MemberRole>Allow</MemberRole>
								<Members>
									<Member
										xsi:type="PassportMember"
									>
											<Type>Passport</Type>
											<State>Accepted</State>
											<PassportName>anotheruser@hotmail.com</PassportName>
									</Member>
								</Members>
							</Membership>
						</memberships>
				</AddMember>
		</soap:Body>
</soap:Envelope>
```

## Server/Response
```
HTTP/1.1 200 OK
Content-Type: text/xml
Content-Length: 771

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
		xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		xmlns:xsd="http://www.w3.org/2001/XMLSchema"
>
		<soap:Header>
				<ServiceHeader
						xmlns="http://www.msn.com/webservices/AddressBook"
				>
						<Version>12.01.1111.0000</Version>
						<CacheKey>12r1;MjAyNC0xMS0xOVQxNzo0ODowOS44MDNa</CacheKey>
						<CacheKeyChanged>true</CacheKeyChanged>
						<PreferredHostName>contacts.example.com</PreferredHostName>
						<SessionId>ecfaf8c7-e388-4571-8641-b061a0ac4bdc</SessionId>
				</ServiceHeader>
		</soap:Header>
		<soap:Body>
				<DeleteMemberResponse
						xmlns="http://www.msn.com/webservices/AddressBook"
				/>
		</soap:Body>
</soap:Envelope>
```