Community articleCreating community forums
Added by IBM contributorIBM on March 18, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

To create a community forum, send a POST request to the remote applications feed of the community to which you want to add the forum.
Tags: commapi



To create a community forum, send a POST request to the remote applications feed of the community to which you want to add the forum.

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

Input

Provide a forum Atom entry document.

Note: The content type of the Atom entry document must be application/atom+xml.

If you want to add some tags to this forum. For each tag, add the <category term="tag name"/> element to the forum entry document that you pass in on the request.

Output

An Atom entry document containing the new forum entry.

Returned HTTP headers

HTTP/1.1 201 Created

Indicates that the community forum was successfully created. If an error occurs, this header contains one of the error codes.

Location: url

Link to edit_url of the new community forum. You can use the web address specified here to subsequently update the community forum.

Input
Method URI Description
POST /forums/atom/service From the entry in the Communities remote application feed that contains the following category: <category term="Forums" scheme="http://www.ibm.com/xmlns/prod/sn/type" /> , find the value of the href attribute in the <link> element that has the following rel attribute value: rel="http://www.ibm.com/xmlns/prod/sn/remote-application/publish".
Content Type: application/atom+xml
Name Type Optional Description
communityUuid
string No The UUID of the commmunity you wish to create the forum in
Output
Content Type: application/atom+xml
Name Type Optional Description
Location
string Yes Link to edit_url of the new community forum. You can use the web address specified here to subsequently update the community forum.
Code Description
201
Created. Indicates that the community forum was successfully created. If an error occurs, this header contains one of the error codes.
400
Bad Request.
403
Forbidden. Authorization failed.