Updates

Updates are short twitter-style posts found in the Edge for a given realm

Table of Contents

Fields

Field Name Description Type Required
body Body

The body text of the update

 string yes
uid Posting user ID

The user ID of the user who posted the update.

 string
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):

RealmPath
Usersusers/{id}
Course Sectionssections/{id}
Groupsgroups/{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