To create a subcommunity, send an Atom entry document containing the new subcommunity to the My Communities resource.
See Authenticating requests
for information about how to authenticate the request.
Table 1. Atom API request details
|POST||User's My communities feed||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://www.ibm.com/xmlns/prod/sn/subcommunities" attribute.||subcommunity|
Provide a subcommunity Atom entry document. A subcommunity is the same as a community entry, but contains a rel="http://www.ibm.com/xmlns/prod/sn/parentcommunity" <link> element. The content type of the Atom entry document must be application/atom+xml.
An Atom entry document containing the new subcommunity entry.
Returned HTTP headers
HTTP/1.1 201 Created
Indicates that the subcommunity was successfully created. If an error occurs, this header contains one of the error codes.Location: url
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.Error codes
Parent topic: Working with subcommunities
Community entry content
- HTTP/1.1 400 Bad Request
- HTTP/1.1 401 Unauthorized