Skip to main content

 Services

Web services from /about to /webhooks

archive comment

/members/{member}/comments/{commentid}/archive [POST]

Description

Archive an existing comment.

If the comment has been posted on multiple groups, archiving the comment removes it from all the groups – even if the member archiving it only has access to one of the groups.

This service only archives a single comment in a discussion such that the other comments are preserved:

  • The replies of an archived comment are always retained, regardless of its position in the discussion.
  • If the archived comment is the first comment in a discussion, the immediately following reply replaces it as the first comment.

Parameters

No parameters required – the comment is specified by the xlinkid in the URL.

Permission

Only contributor and higher can archive comments that have been posted, however, only manager and higher can archive the comments of other members.

A guest and higher can archive their own draft comments.

An administrator can archive any comment.

Response

When successful, the archived comment is returned as a <comment> wrapped in a <comment-archive> element as in the following example.

<comment-archive>
  <comment id="123"
           contentrole="archive-Comment"
           created="2012-03-08T12:34:00+10:00"
           [status="Open"]
           [due="2012-03-10T18:00:00+10:00"]
           [priority="High"] 
           [moderated="true"]>
    <title>Cavern stolen!</title>
    <author email="alibaba@fortythieves.com.au">
      ...
    </author>
    <assignedto id="123"
                date="2012-03-09T..."> ...
    </assignedto>
    <modifiedby id="456"
               date="2012-03-09T..."> ...
    </modifiedby>
    <content id="789"
              type="text/plain">
      Sesame opened the door
    </content>
    <attachment>
      <uri id="189"> ... </uri>
    </attachment>
    <attachment fragment="5">
      <uri id="289"> ... </uri>
    </attachment>
  </comment>
</comment-archive>

The @contentrole of the comment must start with archive- after the comment has been archived.

Error Handling

CodeCause / Description
0x1309The comment is already archived
0x1311The object specified is not a comment
0x1317The comment was not found
0x6304Failed to archive comment
Created on , last edited on