Share via

3.1.4.30 UpdateList

  • Article

The UpdateList operation is used to update list properties and add, remove, or update fields.

 <wsdl:operation name="UpdateList">
     <wsdl:input message="UpdateListSoapIn" />
     <wsdl:output message="UpdateListSoapOut" />
 </wsdl:operation>

The protocol client sends an UpdateListSoapIn request message (section 3.1.4.30.1.1), and the server MUST respond with an UpdateListSoapOut response message (section 3.1.4.30.1.2), as follows:

  1. If the specified listName is a valid GUID and corresponds to the identification of a list on the site, use that list.

  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, use that list.

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

  4. If the listVersion is null, the list MUST be updated and the protocol server MUST return an UpdateListResponse element.

  5. If the listVersion string cannot be converted to an integer, the protocol server MUST return a SOAP fault. There is no error code for this fault.

  6. If the listVersion string is numeric but not within the range of an unsigned 32-bit integer, this operation MUST return a SOAP fault. There is no error code for this fault.

  7. If the listVersion does not match the version of the list, the protocol server MUST return a SOAP fault with error code 0x81020015. This indicates that the list changes are in conflict with those made by another user.