To start following a resource, send an Atom entry document containing information about the resource to the followed resources feed.
See Authenticating requests
for information about how to authenticate the request.
Table 1. Atom API request details
followed resources feed
The web address of the href attribute of the collection in the Following service document for the application
Provide a follow Atom entry document. The content type of the Atom entry document must be application/atom+xml.
An Atom entry document containing the resource that you want to follow.
Returned HTTP headers
HTTP/1.1 201 Created
Indicates that you have successfully started to follow the specified resource. If an error occurs, this header contains one of the error codes.
Link to edit_url of the new follow entry. You can use the web address specified here to subsequently retrieve and update the follow entry.
HTTP/1.1 400 Bad Request
HTTP/1.1 403 Forbidden
For example, if you want to start following a resource in Blogs, you would retrieve the Blogs following service document, which might look like this:
<atom:generator version="3.0" uri="http://www.ibm.com/xmlns/prod/sn">
IBM Connections - Follow service
<atom:title type="text">Follow service for John Donne</atom:title>
<atom:title type="text">Followed blogs for John Donne</atom:title>
To start following a blog, you would send a POST request to the web address in the href attribute of the collection, which in this example, is: https://enterprise.example.com/blogs/follow/atom/resources?source=blogs&type=blog
. Pass a follow Atom entry document in on the request to identify what you want to start following.
Parent topic: Following API
Follow entry content