Community articleMoving a stand-alone forum topic programmatically
Added by IBM contributorIBM on March 10, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

To move a forum topic from one discussion thread to another, use the edit link found in the forum topic entry in the forum topics feed.



To move a forum topic from one discussion thread to another, use the edit link found in the forum topic entry in the forum topics feed.

Before you can move a topic, you must complete the following tasks:

<thr:in-reply-to
href=<web address of the link rel="replies" element>
ref=<id element of new forum>
type="application/atom+xml">
</thr:in-reply-to>


For example:

<thr:in-reply-to
href="https://example.com/forums/atom/topics?
forumUuid=7cf6c58d-0f24-44bc-a18b-9ded332f40d8"
ref="urn:lsid:ibm.com:forum:6b4f9f8d-e979-41e3-b011-d56f4cefbf89"
type="application/atom+xml">
</thr:in-reply-to>


Note: The value of the href attribute, which continues to reference the web address of the replies link for the old forum is automatically updated by the server to reference the new forum after you submit the edited Atom entry document using the PUT request.

1. Retrieve a feed of forums that includes the forum you want to move the topic to. See Getting the My Forums feed.
2. Find the entry representing the forum to which you want to move the topic, and then make a note of the <id> element value.
3. Retrieve the Atom entry document for the forum topic that you want to move. See Retrieving a stand-alone forum topic programmatically.
4. Edit the topic Atom entry document to reference the new forum instead of the old forum by updating the value of the ref attribute in the <thr:in-reply-to> element with the values you noted in a previous step.
5. Save the edited topic Atom entry document.
6. Send a PUT request to the web address specified in the href attribute of the <link rel="edit"> element of the forum topic that you want to move. Include the edited Atom entry document with the request. See the Input section below for details about how to handle attachments and so on.

See Authenticating requests for information about how to authenticate the request.
Input
Method URI Description
PUT /forums/atom/topic Value of the href attribute of the <link> element that has a rel="edit" attribute value for each entry in the forum topics feed.
Content Type: application/atom+xml
Name Type Optional Description
topicUuid
string No The UUID of the topic you wish to move.
Output
Code Description
200
OK. Indicates that the forum topic was successfully updated. If an error occurs, this header contains one of the error codes.
401
Unauthorized.
404
Not Found.
Examples
PUT /forums/atom/topic?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="http://www.w3.org/2005/Atom">

	<id>urn:lsid:ibm.com:forum:84139b22-17f0-4290-939b-73370c6ef17c</id>

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

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

	<updated>2010-08-04T21:45:09.324Z</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/topic?topicUuid=84139b22-17f0-4290-939b-73370c6ef17c"

	rel="self"

	type="application/atom+xml"></link>

	<link

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

	rel="edit"

	type="application/atom+xml">

	</link>

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

	<category term="bb"></category>

	<category term="aa"></category>

	<link

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

	rel="alternate"

	type="text/html">

	</link>

	<link

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

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

	rel="replies"

	type="application/atom+xml"

	thr:count="0">

	</link>

	<thr:in-reply-to

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

	href="https://www.dulcinea.com/forums/atom/topics?forumUuid=e1b8faff-afc7-4ba8-9269-05bfd592efc7"

	ref="urn:lsid:ibm.com:forum:e1b8faff-afc7-4ba8-9269-05bfd592efc7"

	type="application/atom+xml">

	</thr:in-reply-to>

	<content type="html">updated topic 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>


Response returned by the server
HTTP/1.1 200 OK