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.
- Determine the URI to which to POST the bookmark Atom document to create the community forum by first accessing the service document for remote applications. See Retrieving a remote applications list for more details.
- Create an Atom document to represent the community forum.
- Send the Atom document using a POST request to the following URI:
Table 1. Atom API request details
Communities remote applications feed
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".
Provide a forum Atom entry document.
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.
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.Error codes
Parent topic: Working with remote applications
Retrieving a remote applications list
- HTTP/1.1 400 Bad Request
- HTTP/1.1 403 Forbidden: Authorization failed.