Updating forums
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 15, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

To update a stand-alone forum, send an updated forum document in Atom format to the existing forum's edit web address.

All existing forum entry metadata will be replaced with the new data. To avoid deleting all existing data, retrieve any data you want to retain first, and send it back with this request. See Retrieving forums for more information.

If you want to lock the forum, add the element <category scheme="http://www.ibm.com/xmlns/prod/sn/flags" term="locked"/> in the forum entry that you pass in as input. If you want to unlock a forum, remove the same element from the forum entry that you pass in as input.

Input
Method URI Description
PUT /forums/atom/forum Web address returned in the HTTP location header when the forum was created.
Web address of the href attribute of the <link> element with the rel="edit" attribute of a forum Atom entry.
Content Type: application/atom+xml
Name Type Optional Description
forumUuid
string No The UUID of the forum you wish to retrieve.
Output
Code Description
200
Indicates that the forum was successfully updated. If an error occurs, this header contains one of the error codes.
401
Unauthorized.
404
Not Found.
Examples
PUT /forums/atom/forum?forumUuid=3b153694-e27e-4085-8868-2952110fdad2 HTTP/1.1

	Host: www.dulcinea.com

	Content-Type: application/atom+xml

	Authorization: xxx

	Content-Length: nnn

	

	<?xml version="1.0" encoding="UTF-8"?>

	<entry xmlns="http://www.w3.org/2005/Atom" xmlns:app="http://www.w3.org/2007/app" xmlns:snx="http://www.ibm.com/xmlns/prod/sn" xmlns:thr="http://purl.org/syndication/thread/1.0">

	<id>urn:lsid:ibm.com:forum:3b153694-e27e-4085-8868-2952110fdad2</id>

	<title type="text">CKEditor</title>

	<published>2010-08-04T15:13:29.746Z</published>

	<updated>2010-08-04T18:06:59.481Z</updated>

	<author>

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

	<name>Jane Doe</name>

	<snx:userid>F1449510-CF43-D282-8525-7346003DAD9D</snx:userid>

	<snx:userState>active</snx:userState>

	</author>

	<contributor>

	<email>ajones9@janet.iris.com</email>

	<name>Amy Jones9</name>

	<snx:userid>4C259C9C-9F1C-85B0-8525-7346003DB02A</snx:userid>

	<snx:userState>active</snx:userState>

	</contributor>

	<link

	href="http://www.dulcinea.com/forums/atom/entries?forumUuid=3b153694-e27e-4085-8868-2952110fdad2"

	rel="self"

	type="application/atom+xml">

	</link>

	<link

	href="http://www.dulcinea.com/forums/atom/forum?forumUuid=3b153694-e27e-4085-8868-2952110fdad2"

	rel="edit"

	type="application/atom+xml">

	</link>

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

	<category term="ckeditor"></category>

	<link

	href="http://www.dulcinea.com/forums/html/forum?id=3b153694-e27e-4085-8868-2952110fdad2"

	rel="alternate"

	type="text/html">

	</link>

	<link

	href="http://www.dulcinea.com/forums/atom/topics?forumUuid=3b153694-e27e-4085-8868-2952110fdad2"

	rel="replies"

	type="application/atom+xml"

	thr:count="0">

	</link>

	<link

	href="http://www.dulcinea.com/forums/atom/service?forumUuid=3b153694-e27e-4085-8868-2952110fdad2"

	rel="service" type="application/atomsvc+xml"

	title="Atom Publishing Protocol">

	</link>

	<thr:in-reply-to

	href="http://www.dulcinea.com/forums/atom/forums"

	ref="http://www.dulcinea.com/forums/atom/forums"

	type="application/atom+xml">

	</thr:in-reply-to>

	<content type="html">Read a great short story yesterday.</content>

	</entry>


Response returned by the server
HTTP/1.1 200 OK