Skip to content

Course Folder

A course folder request returns all the contents of the folder with pointers to that piece of content if the API supports it. This includes child Folders. If the folder has a parent, there is a <parent> object that has all the fields of a folder object. Its location attribute will point to the parent. A folder with id = 0 is the root of the course. The contents of the folder is returned in the same order that they are in the course. Ordering does matter.

NOTE

Course Folders exist in courses.

Fields

FieldNameDescriptionType
idSchoology ID of the folder contentSchoology ID of the folder contentinteger
titleTitleThe content titlestring
bodyDescription of the ContentIf the content has a description or body this is itstring
typeType of contentType of content {folder, assignment, discussion, media-album}string
locationAPI endpoint to retrieve content fromIf the content is accessible via API this location field points to it.string

GET courses/{course_id}/folder/{folder_id}

View the contents of a specific folder

Return A list of objects within the folder

json
{
  "self": {
    "id": 117703,
    "title": "F8",
    "body": "",
    "available": 1,
    "type": "folder",
    "location": "http:\/\/...",
    "publish_start": "",
    "publish_end": "",
    "status": 1,
    "completion_status": "",
    "has_rules": 0,
    "completed": 0
  },
  "parent": {
    "id": 0,
    "title": "",
    "body": "",
    "available": 1,
    "type": "folder",
    "location": "http:\/\/...",
    "publish_start": "",
    "publish_end": "",
    "status": 0,
    "completion_status": "",
    "has_rules": 0,
    "completed": 0
  },
  "folder-item": [
    {
      "id": 5534077,
      "title": "widget_like_320.zip",
      "body": "",
      "available": 1,
      "completion_status": "",
      "has_rules": 0,
      "completed": 0
    },
    {
      "id": 5534085,
      "title": "Golf Explained - CP Single SCO",
      "body": "",
      "available": 1,
      "type": "package",
      "location": "http:\/\/...",
      "url": "http:\/\/...",
      "completion_status": "",
      "has_rules": 0,
      "completed": 0
    }
  ]
}
xml
<?xml version="1.0" encoding="utf-8" ?>
<result>
	<self>
		<id>117703</id>
		<title>F8</title>
		<body />
		<available>1</available>
		<type>folder</type>
		<location>http:\/\/...</location>
		<publish_start />
		<publish_end />
		<status>1</status>
		<completion_status />
		<has_rules>0</has_rules>
		<completed>0</completed>
	</self>
	<parent>
		<id>0</id>
		<title />
		<body />
		<available>1</available>
		<type>folder</type>
		<location>http:\/\/...</location>
		<publish_start />
		<publish_end />
		<status>0</status>
		<completion_status />
		<has_rules>0</has_rules>
		<completed>0</completed>
	</parent>
	<folder-item>
		<id>5534077</id>
		<title>widget_like_320.zip</title>
		<body />
		<available>1</available>
		<completion_status />
		<has_rules>0</has_rules>
		<completed>0</completed>
	</folder-item>
	<folder-item>
		<id>5534085</id>
		<title>Golf Explained - CP Single SCO</title>
		<body />
		<available>1</available>
		<type>package</type>
		<location>http:\/\/...</location>
		<url>http:\/\/...</url>
		<completion_status />
		<has_rules>0</has_rules>
		<completed>0</completed>
	</folder-item>
</result>