Retrieve Content Item History

Client applications can retrieve an Atom feed containing the edit history of a content item. The history feed contains an entry for each modification made to the content item. An entry in the feed contains the time a change was made, the name of the user who made the change and information about any state change applied to the content item.

If content item staging is enabled, then once a content item is published, any changes made to the draft copy of the content item are not recorded in the history. An entry is only add to the history feed if such changes are published.

A link to an edit history feed is included in every content item's Atom entry resource:

<entry>
  ...
  <link href="http://host-ip-address/webservice/escenic/content/1337/log" 
        rel="http://www.vizrt.com/types/relation/log"/>
  ...
</entry>

A client can retrieve the history feed by following the link, for example:

curl -u user:password -X GET http://host-ip-address/webservice/escenic/content/1337/log

This will return something like:

<feed xmlns="http://www.w3.org/2005/Atom">
  <author>
    <name>Escenic Content Engine</name>
  </author>
  <id>http://host-ip-address:8080/webservice/escenic/content/1337/log</id>
  <link rel="self" href="http://host-ip-address:8080/webservice/escenic/content/1337/log" type="application/atom+xml"/>
  <updated>2012-12-05T08:34:53.041Z</updated>
  <title type="text">Article log</title>
  <link rel="next" href="http://host-ip-address:8080/webservice/escenic/content/1337/log/after/2846?count=10"/>
  <link rel="previous" href="http://host-ip-address:8080/webservice/escenic/content/1337/log/before/2870?count=10"/>
  <entry>
    <updated>2012-11-29T12:33:16.000Z</updated>
    <author>John Doe</author>
  </entry>
  <entry>
    <updated>2012-11-29T12:32:48.000Z</updated>
    <app:control xmlns:app="http://www.w3.org/2007/app" xmlns:vaext="http://www.vizrt.com/atom-ext">
      <app:draft>yes</app:draft>
      <vaext:state>submitted</vaext:state>
    </app:control>
    <author>John Doe</author>
  </entry>
  <entry>
    <updated>2012-11-26T09:35:27.000Z</updated>
    <author>John Doe</author>
  </entry>
  <entry>
    <updated>2012-11-26T09:35:17.000Z</updated>
    <author></author>
  </entry>
</feed>

The edit history is returned as an Atom paged collection. The first entry in the first Atom feed returned represents the most recent change to the content item. The next entry represents the second most recent change, and so on. If there is more than one page of entries, then you can retrieve the next page by following this feed's next link.

An entry with an empty author field represents a change made by an automated process such as the syndication module or a background service.