• Table of Contents
• Previous Next

DeleteCourse

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

You specify the following entities with the DeleteCourse operation:

• CourseHandle. Specifies the handle in your iTunes U site for the course you want to delete. The course handle must correspond to a Course page 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 CourseHandle entity, iTunes U uses the destination string in your URL.

• CoursePath. Specifies the path in your iTunes U site for the course you want to delete. The course path must correspond to a Course page 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 CoursePath entity, iTunes U uses the destination string in your URL. The CoursePath 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” and a course in that section named “Literature,” you can refer to the CoursePath as <CoursePath>CupertinoU/Humanities/Literature</CoursePath> in your DeleteCourse operation. If specifying the root path, you must start the CoursePath 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 (//).

Warning: You cannot undo any changes you make using the DeleteCourse operation. Before you delete a course, you can use the ShowTree operation to obtain your site structure to help in restoring information. However, if you delete a course using DeleteCourse, there is no way to restore the actual course files.

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

<?xml version="1.0" encoding="UTF-8"?>
<ITunesUDocument>
  <Version>1.1.4</Version>
  <DeleteCourse>
    <CourseHandle>coursehandle value</CourseHandle>
    <CoursePath>coursepath value</CoursePath>
  </DeleteCourse>
</ITunesUDocument>