Media Album Comments

Media Album Comments are comments made on individual content within media albums

Table of Contents

Fields

Field Name Description Type Required
content_id Content ID

The ID of the content related to the comment

integer yes
uid User ID

The ID of the user who created the comment

integer
comment Comment

The comment text

string
created Created timestamp

The unix timestamp when the comment was created

integer

Operations

The operations below are available for the following realms (replace [realm] with the appropriate realm and ID):

RealmPath
Course Sectionssections/{id}
Groupsgroups/{id}

create

Create a comment

This endpoint has changed as of 2/15/15. The existing endpoint is still available but no longer maintained:

POST https://api.schoology.com/v1/album/{id}/content/{content_id}/comments
Path

POST https://api.schoology.com/v1/[realm]/albums/{id}/content/{content_id}/comments

Content

An object containing comment fields

JSON
{
    "comment": "nice pic!"
}
XML
<body>
  <comment>nice pic!</comment>
</body>
Return

An object containing comment fields

JSON
{
    "id": 229,
    "content_id": 0,
    "uid": 45552,
    "comment": "This is a media album comment",
    "created": 0,
    "status": 0,
    "links": {
        "self": "http:\/\/...\/comments\/229"
    }
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
    <id>229</id>
    <content_id>0</content_id>
    <uid>45552</uid>
    <comment>This is a media album comment</comment>
    <created>0</created>
    <status>0</status>
    <links>
        <self>http://.../comments/229</self>
    </links>
</result>

list

View a list of comments (paged)

This endpoint has changed as of 2/15/15. The existing endpoint is still available but no longer maintained:

GET https://api.schoology.com/v1/album/{id}/content/{content_id}/comments
Path

GET https://api.schoology.com/v1/[realm]/albums/{id}/content/{content_id}/comments

Content

none

Return

A collection of comment objects, each one containing comment fields

JSON
{
    "comment": [
        {
            "id": 229,
            "content_id": 17861,
            "uid": 45552,
            "comment": "This is a media album comment",
            "created": 1388420575,
            "status": 1
        }
    ]
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
    <comment>
        <id>229</id>
        <content_id>17861</content_id>
        <uid>45552</uid>
        <comment>This is a media album comment</comment>
        <created>1388420575</created>
        <status>1</status>
    </comment>
</result>

view

View a specified comment

This endpoint has changed as of 2/15/15. The existing endpoint is still available but no longer maintained:

GET https://api.schoology.com/v1/album/{id}/content/{content_id}/comments/{comment_id}
Path

GET https://api.schoology.com/v1/[realm]/albums/{id}/content/{content_id}/comments/{comment_id}

Content

none

Return

An object containing comment fields

JSON
{
    "id": 229,
    "content_id": 17861,
    "uid": 45552,
    "comment": "This is a media album comment",
    "created": 1388420575,
    "status": 1
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
	<id>229</id>
	<content_id>17861</content_id>
	<uid>45552</uid>
	<comment>This is a media album comment</comment>
	<created>1388420575</created>
	<status>1</status>
</result>

delete

Delete a comment (cannot be undone)

This endpoint has changed as of 2/15/15. The existing endpoint is still available but no longer maintained:

DELETE https://api.schoology.com/v1/album/{id}/content/{content_id}/comments/{comment_id}
Path

DELETE https://api.schoology.com/v1/[realm]/albums/{id}/content/{content_id}/comments/{comment_id}

Content

none

Return

none