When using this API in an IBM SmartCloud
™ for Social Business environment, note that certain differences might exist. For more information, see Communities API
in the IBM Social Business Development wiki.
See Authenticating requests
for information about how to authenticate the request.
Table 1. Atom API request details
|POST||Community forum topics ||Value of the href attribute of the <link> element with the rel="http://www.ibm.com/xmlns/prod/sn/forum-topics" attribute value for each community.||forum topic|
Provide a forum topic Atom entry document.
The content type of the Atom entry document must be application/atom+xml
An Atom entry document containing the new forum topic.
Returned HTTP headers
HTTP/1.1 201 Created
Indicates that the forum topic was successfully created. If an error occurs, this header contains one of the error codes.Location: url
Link to edit_url of the forum topic. You can use the web address specified here to subsequently retrieve and update the forum topic.Error codes
Parent topic: Working with community forum topics
Forum topic entry content
- HTTP/1.1 400 Bad Request
- HTTP/1.1 401 Unauthorized
- HTTP/1.1 404 No forum exists: This error is generated when the community does not contain a forum. When you create a community, a forum is created for it by default, but the administrator can remove or hide the forum. See Administering Forums for more details.