Community articleRetrieving a subcommunity
Added by IBM contributorIBM on March 14, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

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



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

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.

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.

Input
Method URI Description
GET /communities/service/atom/community/instance {{{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.
Name Type Optional Description
communityUuid
string No The uuid of the SUBCOMMUNITY you wish to retrieve.
Output
Content Type: application/atom+xml
Code Description
200
Indicates that the subcommunity entry was successfully found and returned. If an error occurs, this header will contain one of the error codes below.
401
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.
404
Not Found