To retrieve a subcommunity entry, use the edit link for the subcommunity entry which can be found in the My Communities feed.

When using this API in an IBM SmartCloud™ for Social Business environment, note that certain differences might exist. For more information, see Communities API in the IBM Social Business Development wiki.
You can use this operation to obtain subcommunity entry information that you want to preserve prior to performing an update. See Updating subcommunities for more information. This method returns the Atom entry of a single subcommunity as opposed to a feed of the community. If you want to retrieve a feed, see Getting the Subcommunities feed.

See Authenticating requests for information about how to authenticate the request.

Table 1. Atom API request details

Method

Resource

URI

Output representation

GET

subcommunity

Value of the href attribute of the <link> element that has a rel="edit" attribute for each entry that represents a subcommunity in the My Communities feed.

Web address returned in the HTTP location header when the subcommunity was created.

subcommunity

Input

None.

Output

An Atom entry document containing the subcommunity entry. A subcommunity is the same as a community entry, but contains a rel="http://www.ibm.com/xmlns/prod/sn/parentcommunity" <link> element.

Returned HTTP headers

HTTP/1.1 200 OK

Indicates that the subcommunity entry was successfully found and returned. If an error occurs, this header will contain one of the error codes below.