Creating subcommunities
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 15, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

To create a subcommunity, send an Atom entry document containing the new subcommunity to the My Communities resource.
Tags: commapi
Provide a subcommunity Atom entry document. A subcommunity is the same as a community entry, but contains a rel="" <link> element. The content type of the Atom entry document must be application/atom+xml.
Method URI Description
POST /communities/service/atom/community/subcommunities In the My Communities{{{ feed, find the value of the href attribute of the <link> element for the community to which you want to add the subcommunity that has the rel="}}}{{{http}}}{{{://" attribute.}}}
Content Type: application/atom+xml
Sample Request:
<?xml version="1.0" encoding="UTF-8"?>






<title type="text">SubSubSub</title>

<content type="html">Share information about day care.</content>

<category term="community" scheme=""></category>

<link href="" rel="" type="application/atom+xml"></link>


Name Type Optional Description
string No The UUID of the community you wish to create the subcommunity in.
Content Type: application/atom+xml
Name Type Optional Description
string No Link to edit_url of the new subcommunity entry. You can use the web address specified here to subsequently retrieve and update the subcommunity entry.
Code Description
Indicates that the subcommunity was successfully created. If an error occurs, this header contains one of the error codes.
Bad Request.
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.