Creating a community forum topic
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 16, 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 topic to a community forum, send an Atom entry document containing the forum topic to the community forum topics resource.
Tags: commapi
Provide a forum topic Atom entry document.

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

If you want to create a question instead of a normal topic, add the <category term="question" scheme=""/> element to the topic entry document that you pass in on the request.

To create a topic with an attachment, use a multipart post in the request. See Creating a stand-alone forum topic  for more details.

Method URI Description
POST /communities/service/atom/community/forum/topics Value of the href attribute of the <link> element with the rel="" attribute value for each community.
Content Type: application/atom+xml
Sample Request:
<?xml version="1.0" encoding="UTF-8"?>





<category scheme="" term="forum-topic"/>

<title type="text">TEXT OF TOPIC</title>

Name Type Optional Description
string No The UUID of the community you wish to create a forum topic in.
Content Type: application/atom+xml
Name Type Optional Description
string No Link to edit_url of the forum topic. You can use the web address specified here to subsequently retrieve and update the forum topic.
Code Description
Bad Request.
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.
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.
OK. Indicates that the request was received successfully, and that you should use <snx:communityUuid xmlns:snx="">3a246a15-b4d6-44e1-a01d-1c3d89f1f9a4</snx:communityUuid> in the body when creating the request