Skip to main content

 Services

Web services from /about to /webhooks

reply comment public

/comments/{commentid}/reply [POST]

Description

Create a reply to an existing comment with author as a parameter.

Parameters

NameDescriptionRequiredTypeDefault
authornameThe name of the authoryesstring
contentThe content of the commentyesstring
assignedtoThe ID of the member to assign the task to – status or previous status MUST be set ('' means unassign)nolongthe assigned member of the previous comment in thread
authoremailThe email address of the authornoemail
contenttypeThe media type of the commentnomediatypetext/plain
dueThe task due date format is ISO-8601 – status or previous status MUST be set e.g. 2010-10-25, 2010-10-25T12:26 (defaults to T18:00)nodatethe due date of previous comment in thread
labelsA comma-separated list of label valuesnostring
notifyThe notification behaviornonotifynormal
notify-asyncWhether emails should be sent asynchronously (for slow email servers)nobooleanfalse
priorityThe priority for the task e.g. High, Medium, Low – status or previous status MUST be setnoprioritythe priority of the previous comment in thread
propertiesA pipe-separated list of value pairs (e.g. x=1|y=2|)nostring
statusThe task status value, e.g. Opennostatusthe status of the previous comment in thread
titleThe title of the commentnostringthe reply to comment's title
typeThe type of the commentnostring
urisComma-separated list of attachments as URI ID with optional !fragmentnolongs
urlsComma-separated list of attachments as URL with optional #fragmentnourls

Permission

This service is public, anyone can invoke it since the comment is in a public group.

Response

<comment-creation [notification-email-delayed="true"|
                  notification-email-failed="true"|
                  moderator-email-failed="true"]
                  [notify-param-ignored="true"]
                  [public="true"]>
  <comment id="123"
           discussionid="122"
           contentrole="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>
    <context fragment="2">
      <uri|group  id="789"> ... </uri|group>
    </context>
    <attachment>
      <uri id="189"> ... </uri>
    </attachment>
    <attachment fragment="5">
      <uri id="289"> ... </uri>
    </attachment>
  </comment>
</comment-creation>

Error Handling

CodeCause / Description
0x1301 If the author is missing
0x1302 If the author is existing and was specified using authorname or authoremail
0x6301 If the group has no general discussion
0x6302 Failed to create new comment
Created on , last edited on