Share via

3.1.4.13 DeleteList

  • Article

The DeleteList operation deletes the specified list from the specified site.

 <wsdl:operation name="DeleteList">
     <wsdl:input message="DeleteListSoapIn" />
     <wsdl:output message="DeleteListSoapOut" />
 </wsdl:operation>

The protocol client sends a DeleteListSoapIn request message (section 3.1.4.13.1.1), and the protocol server MUST responds with a DeleteListSoapOut response message (section 3.1.4.13.1.2), as follows:

  1. If the specified listName is a valid GUID and corresponds to the identification of a list on the site, that list MUST be deleted and the protocol server MUST return a DeleteListResponse element (section 3.1.4.13.2.2).

  2. If the specified listName is not a valid GUID or does not correspond to the identification of a list on the site, check if the listName corresponds to the list title of a list on the site and if so, that list MUST be deleted and the protocol server MUST return a DeleteListResponse element.

  3. If the specified listName does not correspond to a list from either of these checks, the protocol server SHOULD<52> return a SOAP fault with error code 0x82000006. This indicates that the list does not exist or it might have been deleted by another user.

  4. If there are no other errors, the list MUST be deleted.