Web service API

How to use PageSeeder's Web service API

create comment uri fragment public

/uris/{uri}/fragments/{+fragment}/comments [POST]



Create a new comment for URI fragment

Create a comment for group, reply, url or uri/fragment.


Comments support two types of metadata:

  • properties, a set of values pairs
  • labels

Task details

This service can be used to either turn a thread into a task or to edit the task details of a task.

Task details are automatically inherited from the previous comment in the thread.


NameDescriptionRequiredTypeDefault value
authornamethe name of the authoryesstring
contentThe content of the commentyesstring
groupsA comma-separated list of the groups the comment should belong toyesstrings
titleThe title of the commentyesstring
assignedtoThe member ID of the member the task should be assigned to - status MUST be setnolong
authoremailthe email of the authornoemail
contenttypeThe content type of the commentnomediatypetext/plain
dueThe task due date format is ISO-8601 - status MUST be set e.g. 2010-10-25, 2010-10-25T12:26 (defaults to T18:00)nodate
fragmentThe fragmentnostring
labelsA comma-separated list of labelsnolabels
notifyThe notification behaviornonotifynormal 
notify-async Whether to send emails asynchronously (for slow email servers). no boolean false
priorityThe priority for task e.g. 'High', 'Medium', 'Low' - status MUST be setnopriority
propertiesA pipe-separated list of properties as value pairs (e.g. x=1|y=2|)nostring
statusThe status for task e.g. 'Open', 'Resolved', 'Closednostatus
typeThe type of the commentnostring
urisThe attachments to this comment (comma-separated list of URI IDs with optional !fragments)nolongs
urlsThe attachments to this comment (comma-separated list of urls with optional #fragments)nourls


Undocumented permissions requirements.


<comment-creation [notification-email-delayed="true"|
   <comment id="123"
       <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>
         <uri id="189">...</uri>
       <attachment fragment="5">
         <uri id="289">...</uri>

Error Handling

CodeCause / Description
0x1002 Invalid email address
0x1301 If the author is missing
0x1302 If the author is existing and was specified using authorname or authoremail
0x1303 Both URI and URL have been specified
0x1304 The URL is invalid
0x1305 The URL does not match a GroupURI
0x1306 The Group is invalid
0x1307 The assigned to member is invalid
0x1308 The due date is invalid
0x6301 If the group has no general discussion
0x6302 Failed to create new comment

Created on , last edited on