Returns the subfolders in a Spotlight or Presentation’s playlist
This call returns the subfolders found inside a folder in a Spotlight or Presentation’s playlist. Three path parameters are required:
- The id of a Spotlight or Presentation
- The id of a playlist featured in that Spotlight or Presentation
- The id of a folder included in that playlist
A 200 code is returned when one or more subfolders are found inside the playlist folder. The response includes the properties of each subfolder, including its name and id. For an overview of folder properties, please see the table in Get folders.
Note that a subfolder may contain additional levels of subfolders. However, those deeper subfolders are not included in the response. The response only contains the subfolders located inside the folder whose folder id you enter.
If a folder does not contain any subfolders, then a 200 code is returned with an empty response body.
If the folder id does not match a folder contained in the playlist, then a 401 message is returned with the message “Folder id is not in Playlist Scope.”
If the playlist id does not match a playlist in the Spotlight or Presentation, then a 401 is returned with the message “Playlist does not exist in presentation.”