Updates

Fields

FieldNameDescriptionTypeRequired
body Body The body text of the update string yes
uid Posting user ID The user ID of the user who posted the update. integer
display_name Posting user display name The display name of the user who posted the update. string
last_updated Last updated timestamp The unix timestamp of the most recent time the post was created/modified. string
attachment/type Attachment type For updates with attachments, the type of the attachment {'file','link','video'}
attachment/title Attachment title The display value of the link to the attachment string
attachment/url Attachment URL The absolute URL of the attachment string
attachment/thumbnail Attachment thumbnail For attachments of type 'link', a thumbnail screenshot of the linked page string
poll/options Poll options For updates with polls attached to them, this array will hold all of the poll's options. array
poll/options/title Poll option title The title and displayable name of the given poll option string
poll/options/count Poll option vote count The number of users who have selected this option in the poll int
poll/options/selected Poll option selected This variable is true if the current user selected this poll item bool

Operations

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

Realm Path
Users users/{id}
Course Sections sections/{id}
Groups groups/{id}

create

Create an update for the signed-in user.

Path

POST https://api.schoology.com/v1/[realm]/updates

Content

An object containing update fields

JSON
{
    "body": "this is new message",
    "attachments": [
        {
            "type": "link",
            "title": "g.0",
            "url": "http:\/\/www.google.com"
        }
    ]
}
XML
<body>
  <body>this is new message</body>
  <attachments>
    <attachment>
      <type>link</type>
      <title>g.0</title>
      <url>http://www.google.com</url>
    </attachment>
  </attachments>
</body>
Return

An object containing update fields

JSON
{
    "id": 5692165,
    "body": "this is new message",
    "uid": 45552,
    "created": 1388169771,
    "likes": 0,
    "user_like_action": false,
    "realm": "user",
    "user_id": 45552,
    "attachments": {
        "links": {
            "link": [
                {
                    "id": 1458865,
                    "type": "link",
                    "url": "http:\/\/www.google.com",
                    "title": "g.O",
                    "summary": ""
                }
            ]
        }
    }
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
	<id>5692165</id>
	<body>this is new message</body>
	<uid>45552</uid>
	<created>1388169771</created>
	<likes>0</likes>
	<user_like_action></user_like_action>
	<realm>user</realm>
	<user_id>45552</user_id>
	<attachments>
		<links>
			<link>
				<id>1458865</id>
				<type>link</type>
				<url>http://www.google.com</url>
				<title>g.O</title>
				<summary />
			</link>
		</links>
	</attachments>
</result>

list

View a list of updates (paged). The URL '/recent' is an alias for '/users/%uid/updates' where %uid is the user id of the signed in user. The following query strings can (optionally) be appended to the path to filter results:

  • with_attachments: retrieve attachments and polls for this piece of content.
Path

GET https://api.schoology.com/v1/[realm]/updates

Content

none

Return

A collection of update objects, each one containing update fields

JSON
{
    "update": [
        {
            "id": 5692167,
            "body": "this is another message",
            "uid": 45552,
            "created": 1388169887,
            "likes": 0,
            "user_like_action": false,
            "realm": "user",
            "user_id": 45552,
            "num_comments": 0
        },
        {
            "id": 5692165,
            "body": "this is new messag",
            "uid": 45552,
            "created": 1388169771,
            "likes": 0,
            "user_like_action": false,
            "realm": "user",
            "user_id": 45552,
            "num_comments": 0
        },
        {
            "id": 344360,
            "body": "adfasdfasdf cccccc",
            "uid": 45552,
            "created": 1348781638,
            "likes": 0,
            "user_like_action": false,
            "realm": "user",
            "user_id": 45552,
            "num_comments": 0
        }
    ],
    "links": {
        "self": "http:\/\/...\/updates?start=0&limit=20"
    }
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
    <update>
        <id>5692167</id>
        <body>this is another message</body>
        <uid>45552</uid>
        <created>1388169887</created>
        <likes>0</likes>
        <user_like_action></user_like_action>
        <realm>user</realm>
        <user_id>45552</user_id>
        <num_comments>0</num_comments>
    </update>
    <update>
        <id>5692165</id>
        <body>this is new messag</body>
        <uid>45552</uid>
        <created>1388169771</created>
        <likes>0</likes>
        <user_like_action></user_like_action>
        <realm>user</realm>
        <user_id>45552</user_id>
        <num_comments>0</num_comments>
    </update>
    <update>
        <id>344360</id>
        <body>adfasdfasdf cccccc</body>
        <uid>45552</uid>
        <created>1348781638</created>
        <likes>0</likes>
        <user_like_action></user_like_action>
        <realm>user</realm>
        <user_id>45552</user_id>
        <num_comments>0</num_comments>
    </update>
    <links>
        <self>http://.../updates?start=0&amp;limit=20</self>
    </links>
</result>

view

View a specified update. The following query strings can (optionally) be appended to the path to filter results:

  • with_attachments: retrieve attachments of this piece of content.
Path

GET https://api.schoology.com/v1/[realm]/updates/{id}

Content

none

Return

An object containing update fields

JSON
{
    "id": 5692167,
    "body": "this is another message",
    "uid": 45552,
    "created": 1388169887,
    "likes": 0,
    "user_like_action": false,
    "realm": "user",
    "user_id": 45552,
    "num_comments": 0
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
	<id>5692167</id>
	<body>this is another message</body>
	<uid>45552</uid>
	<created>1388169887</created>
	<likes>0</likes>
	<user_like_action></user_like_action>
	<realm>user</realm>
	<user_id>45552</user_id>
	<num_comments>0</num_comments>
</result>

delete

Delete an update (cannot be undone)

Path

DELETE https://api.schoology.com/v1/[realm]/updates/{id}

Content

none

Return

none

update

Edit the body of an update. Note that if somebody other than the user who created the update (e.g. an Admin) edits the update, the User ID will not be updated.

Path

PUT https://api.schoology.com/v1/[realm]/updates/{id}

Content

An object containing update fields

JSON
{
    "body": "this is new (updated) message",
    "attachments": [
        {
            "type": "link",
            "title": "y.0",
            "url": "http:\/\/www.yahoo.com"
        }
    ]
}
XML
<body>
  <body>this is new (updated) message</body>
  <attachments>
    <attachment>
      <type>link</type>
      <title>y.0</title>
      <url>http://www.yahoo.com</url>
    </attachment>
  </attachments>
</body>
Return

An object containing update fields