Updating a wiki page
Added by IBM contributorIBM | Edited by Elizabeth J Bowling on March 16, 2016
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars1 comment

Update a wiki page.
  1.  Retrieve the existing wiki page Atom document. See Retrieving a wiki page for more details.
  2. Edit the wiki page Atom document to include the information you want to change.
  3. Send the updated Atom document using the following request:

You can use one or more of these input parameters with the PUT request. Separate multiple parameters with an ampersand (&).


Provide an updated wiki page Atom entry document.

Input
Method URI Description
PUT /wikis/{auth}/api/wiki/{wiki-label}/page/{page-label}/entry Determine the resource URI in either of the following ways: Value of the href attribute of the rel="edit" <link> element for each wiki page Atom entry, which are provided in the wiki pages collection. You can construct the URI using the following syntax: /{auth}/api/wiki/{wiki-label}/page/{page-label}/entry where {wiki-label} is the value of the <td:label> element in the wiki definition Atom entry document and {page-label} is the value of the <td:label> element in the wiki page Atom document.
Content Type: application/atom+xml
Name Type Optional Description
wiki-label
string No is the value of the <td:label> element in the wiki definition Atom entry document
The label is also the Community Uuid
page-label
string No is the value of the <td:label> element in the wiki page Atom document.
auth
enumerated No The authorization protocol being used by your application to access Connections Cloud.
Authorized values:
  • basic
  • oauth
Name Type Optional Description
createVersion
boolean Yes Specify "true" to create a new version of the page or "false" overwrite the current version.
draft
boolean Yes Specify "true" to mark the page as a draft, or "false" otherwise.
includeNotification
boolean Yes Specify "true" to request the metadata on notification (edit or comment added) to be included for the document entry.
sendNotification
boolean Yes Specify "true" if you want to send edit or comment notifications.
Name Type Optional Description
Authorization
enumerated No The authentication mechanism selected by your application to access the API.
Basic is the Base64 encoding of the IBM Connections Cloud username and password: Base64(username:password). For example, Base64(twatson@us.ibm.com:password).
Bearer is the oauth 2.0 access token that is generated when the user grants your application access to IBM Connections Cloud services.
See the reference topic "OAuth 2.0 APIs for web server flow" for more information.
Authorized values:
  • bearer
  • basic
Output
Code Description
200
OK. Indicates that the request was received successfully.
401
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.
404
Examples
Update a wiki page to add the title "DISCO" and a add new paragraph "This is Kevin's wiki page." to the content.
<entry xmlns="http://www.w3/org/2--5/Atom">
<title type="text">DISCO</title?
  <summary />
  <content type="text/xml"><p>This is Kevin's wiki page.</p>
  </content>
</entry>

Sebastian M Zmener commented on Jun 9, 2015

Re: Updating a wiki page

It would be useful to have a sample of an atom document for wiki updates.