• Table of Contents
• Previous Next

DeleteSection

Specifies a section you want to delete from your iTunes U site.

You specify the following entities with the DeleteSection operation:

• SectionHandle. Specifies the handle in your iTunes U site for the section you want to delete. The section handle must correspond to a section item in your iTunes U site. If the handle does not match an existing item, iTunes U returns an error message. If you do not specify the SectionHandle entity, iTunes U uses the destination string in your URL.

• SectionPath. Specifies the path in your iTunes U site for the section you want to delete. The section path must correspond to a section item in your iTunes U site. If the path does not match an existing item, or matches multiple items, iTunes U returns an error message. If you do not specify the SectionPath entity, iTunes U uses the destination string in your URL. The SectionPath entity must be in the form “a/b/c” where a, b, and c are folder names. For example, if you have a site named “CupertinoU” containing a section named “Humanities,” you can refer to the SectionPath as <SectionPath>CupertinoU/Humanities</SectionPath> in your DeleteSection operation. If specifying the root path, you must start the SectionPath entity with a leading slash (/). To specify a slash (/) as a character within a node of the slash-delimited path, escape the character with a second slash (//).

Note: If you do not specify a handle or path, iTunes U determines the destination from the destination string in the URL. If you specify a handle, with or without a path, iTunes U uses the handle. If you do not specify a handle but instead specify a path, iTunes U uses the path. If you specify both a handle and path, iTunes U uses the handle.

Warning: You cannot undo any changes you make using the DeleteSection operation.

The following is an example of an iTunes U Web Services document using DeleteSection:

<?xml version="1.0" encoding="UTF-8"?>
<ITunesUDocument>
  <Version>1.1.4</Version>
  <DeleteSection>
    <SectionHandle>sectionhandle value</SectionHandle>
  </DeleteSection>
</ITunesUDocument>