Stop following a resource
To stop following a resource, use the HTTP DELETE method.See Authenticating requests for information about how to authenticate the request.
Table 1. Atom API request details
Method Resource URI Input and output representations DELETE follow entry Value of the href attribute of <link> element that has a rel="edit" attribute value for each entry in the following feed. none
Input
None.
Output
None.Returned HTTP headers
HTTP/1.1 204 No Content
Indicates that you have successfully stopped following the specified resource and no content is returned.
- HTTP/1.1 400 Bad Request
- HTTP/1.1 403 Forbidden
- HTTP/1.1 404 Not Found
For example, to stop following something, first find the resource that you want to stop following in the following feed. From the Following service document for the application, retrieve the web address of the collection from its href attribute. Send a GET request to that web address to retrieve the Following feed. For example, if the collection looks like this:
<service> <atom:generator version="3.0" uri="http://www.ibm.com/xmlns/prod/sn"> IBM Connections - Follow service </atom:generator> <workspace> <atom:title type="text">Follow service for John Donne</atom:title> <collectionhref="https://enterprise.example.com/blogs/follow/atom/resources? source=blogs&type=blog"> ... </service>you would send the GET request to the https://enterprise.example.com/blogs/follow/atom/resource?source=blogs&type=blog web address. This returns the Following feed, which might look like this:
<feed> <generator uri="http://www.ibm.com/xmlns/prod/sn" version="3.0.1.0"> IBM Connections - Follow service </generator> <title type="text">Followed resources for John Donne</title> <updated>2010-09-15T17:53:26.864Z</updated> <id> urn:lsid:ibm.com:follow:feed-com.ibm.lc.1bc09022-0655-4543-a053-93e57e4cec44 </id> <openSearch:itemsPerPage>20</openSearch:itemsPerPage> <openSearch:startIndex>1</openSearch:startIndex> <openSearch:totalResults>1</openSearch:totalResults> <link rel="self" href="https://enterprise.example.com/blogs/follow/atom/resources?ps=20&page=1& source=blogs&type=blog&lang=en_us" type="application/atom+xml"/> <link rel="alternate" href="https://enterprise.example.com/blogs" type="text/html"/> <author> <name>John Donne</name> <snx:userid>50730340-0101-102e-88e1-f78755f7e0ed</snx:userid> <snx:userState>active</snx:userState> <email>jdonne@example.com</email> <uri> https://enterprise.example.com/profiles/html/profile.do? userid=50730340-0101-102e-88e1-f78755f7e0ed </uri> </author> <entry> <id> urn:lsid:ibm.com:follow:resource-c78275d7-8844-4f0f-9b98-356a5f4cb6b8 </id> <category term="resource-follow" scheme="http://www.ibm.com/xmlns/prod/sn/type"/> <category term="blogs" scheme="http://www.ibm.com/xmlns/prod/sn/source"/> <category term="blog" scheme="http://www.ibm.com/xmlns/prod/sn/resource-type"/> <category term="5f85a6ad-8276-4697-b4df-8b9152353430" scheme="http://www.ibm.com/xmlns/prod/sn/resource-id"/> <title type="text">Lotus Software Blog Entry60942</title> <link href="https://enterprise.example.com/blogs/follow/atom/resources/ c78275d7-8844-4f0f-9b98-356a5f4cb6b8?source=BLOGS&type=BLOG& resource=5f85a6ad-8276-4697-b4df-8b9152353430" rel="edit" type="application/atom+xml"/> <link href="https://enterprise.example.com/blogs/roller-ui/rendering/feed/BlogHome60942/ entries/atom" rel="related" type="application/atom+xml"/> <link href="https://enterprise.example.com/blogs/BlogHome60942" rel="alternate" type="text/html"/> </entry> </feed>To stop following a resource, find its rel="edit" link and send a DELETE request to the web address specified in its href attribute. In this case, the only resource being followed has the following edit link URL: https://enterprise.example.com/blogs/follow/atom/resources/c78275d7-8844-4f0f-9b98-356a5f4cb6b8?source=BLOGS&type=BLOG&resource=5f85a6ad-8276-4697-b4df-8b9152353430
Parent topic
Follow API