Creating a stand-alone forum reply
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 post a reply to a topic in a stand-alone forum, send an Atom entry document containing the forum reply to the forum replies resource.
To create a reply with an attachment, use a multipart post in the request. See Creating a stand-alone forum topic for more details.
Input
Method URI Description
POST /forums/atom/replies Value of the href attribute of the <link> element with the rel="replies" attribute value in the forum topics feed.
Content Type: application/atom+xml
Sample Request:
<entry xmlns:thr="http://purl.org/syndication/thread/1.0" xmlns="http://www.w3.org/2005/Atom">

    <title type="text">Test reply 1</title>

    <content type="text">reply test</content>

    <updated>2010-08-04T13:48:48.622Z</updated>

    <category scheme="http://www.ibm.com/xmlns/prod/sn/type" term="forum-reply"></category>

    <thr:in-reply-to 

     xmlns:thr="http://purl.org/syndication/thread/1.0" 

     ref="urn:lsid:ibm.com:forum:84139b22-17f0-4290-939b-73370c6ef17c" 

     href="https://www.dulcinea.com/forums/atom/topic?topicUuid=84139b22-17f0-4290-939b-73370c6ef17c">

   </thr:in-reply-to>

</entry>
Name Type Optional Description
topicUuid
string No The UUID of the topic you wish to reply to.
Name Type Optional Description
X-LConn-RunAs
string Yes The value should be in such format: userid=<user ext id>,username=<user name>,useremail=<user mail> . This header enables impersonation and must works with Forums admin user to authenticate request. If the user does not exists, an inactive user will be created with specified userid , username and usermail. If the user exists, username and useremail can be omitted. eg:userid=BFB5FDCB-B0E2-408A-A351-09103D8D5527,username=xxxxxx,useremail=xxxx@cn.ibm.com
Output
Content Type: application/atom+xml
Name Type Optional Description
Location
string No Link to edit_url of the forum reply. You can use the web address specified here to subsequently retrieve and update the forum reply.
Code Description
201
Indicates that the forum reply was successfully created. If an error occurs, this header contains one of the error codes.
400
Bad Request.
401
Unauthorized.
Examples
POST /forums/atom/replies?topicUuid=84139b22-17f0-4290-939b-73370c6ef17c HTTP/1.1

Host: www.dulcinea.com

Content-Type: application/atom+xml

Authorization: xxx

Content-Length: nnn

 

<entry xmlns:thr="http://purl.org/syndication/thread/1.0" xmlns="http://www.w3.org/2005/Atom">

    <title type="text">Test reply 1</title>

    <content type="text">reply test</content>

    <updated>2010-08-04T13:48:48.622Z</updated>

    <category scheme="http://www.ibm.com/xmlns/prod/sn/type" term="forum-reply"></category>

    <thr:in-reply-to 

     xmlns:thr="http://purl.org/syndication/thread/1.0" 

     ref="urn:lsid:ibm.com:forum:84139b22-17f0-4290-939b-73370c6ef17c" 

     href="https://www.dulcinea.com/forums/atom/topic?topicUuid=84139b22-17f0-4290-939b-73370c6ef17c">

   </thr:in-reply-to>

</entry>



Response returned by the server
HTTP/1.1 201 Created

Date: Wed, 04 Aug 2010 21:45:09 GMT

Content-Length: nnn

Content-Type: application/atom+xml; charset="utf-8"

Location: http://www.dulcinea.com/forums/atom/replies

 

<entry xmlns="http://www.w3.org/2005/Atom">

    <id>urn:lsid:ibm.com:forum:c8979fef-0be3-4f71-b080-7926aa1c270c</id>

    <title type="text">Test reply 1</title>

    <published>2010-08-04T21:45:11.215Z</published>

    <updated>2010-08-04T21:45:11.215Z</updated>

    <author>

        <email>jdoe@literature.com</email>

        <name>Jane Doe</name>

        <snx:userid xmlns:snx="http://www.ibm.com/xmlns/prod/sn">

         772A006E-0A01-8703-8525-7346003DAFD6

        </snx:userid>

        <snx:userState xmlns:snx="http://www.ibm.com/xmlns/prod/sn">active</snx:userState>

    </author>

    <link 

     href="https://www.dulcinea.com/forums/atom/reply?replyUuid=c8979fef-0be3-4f71-b080-7926aa1c270c" 

     rel="self" 

     type="application/atom+xml">

    </link>

    <link 

     href="https://www.dulcinea.com/forums/atom/reply?replyUuid=c8979fef-0be3-4f71-b080-7926aa1c270c" 

     rel="edit" 

     type="application/atom+xml">

    </link>

    <category term="forum-reply" scheme="http://www.ibm.com/xmlns/prod/sn/type"></category>

    <link 

     href="https://www.dulcinea.com/forums/html/topic?id=

      84139b22-17f0-4290-939b-73370c6ef17c#c8979fef-0be3-4f71-b080-7926aa1c270c" 

     rel="alternate" 

     type="text/html">

    </link>

    <link 

     xmlns:thr="http://purl.org/syndication/thread/1.0" 

     href="https://www.dulcinea.com/forums/atom/replies?replyUuid=c8979fef-0be3-4f71-b080-7926aa1c270c" 

     rel="replies" 

     type="application/atom+xml" 

     thr:count="0">

    </link>

    <thr:in-reply-to 

     xmlns:thr="http://purl.org/syndication/thread/1.0" 

     ref="urn:lsid:ibm.com:forum:84139b22-17f0-4290-939b-73370c6ef17c" 

     href="https://www.dulcinea.com/forums/atom/topics?forumUuid=84139b22-17f0-4290-939b-73370c6ef17c" 

     type="application/atom+xml">

    </thr:in-reply-to>

    <content type="html">reply test</content>

    <snx:permissions xmlns:snx="http://www.ibm.com/xmlns/prod/sn">

     none, create_forum, view_forum, edit_forum, del_forum, create_post, edit_personal_post, edit_all_post, 

     del_personal_post, del_all_post, pin_topic, subscribe, lock_node, add_member, delete_member, 

     create_topictag, del_all_topictag, del_personal_topictag, create_forumtag, del_all_forumtag, 

     del_personal_forumtag, view_category, edit_personal_question, edit_all_question

    </snx:permissions>

</entry>