Skip to main content

 Services

Web services from /about to /webhooks

find discussions

/members/{member}/discussions/find [GET]

Description

Find discussions.

Load a list of discussions using filter parameters. A comment in the discussion must match all filter parameters. The discussions with the most recent last comment are returned first.

Parameters

NameDescriptionRequiredTypeDefault
attachmentsThe attachments to include, can be none, context, allnoenumall
authorThe ID of the comment authornolong
commentsThe replies to include, can be none, first, last, all, archivenoenumlast
contentsThe contents to include, can be none, allnoenumall
contextOnly return comments in this context, can be group, uri, allnoenumall
createdafterThe date time after which the comments were created, format is ISO-8601 e.g. 2010-10-25T12:26:00+10:00nodatetime
createdbeforeThe date time before which the comments were created, format is ISO-8601 e.g. 2011-08-25T10:20:00-04:00nodatetime
discussionsizeThe maximum number of comments to return per discussion (0 = unlimited)nointeger100
emailsThe email addresses to include, can be none or all (administrator only)noenumnone
groupsA comma-separated list of group names the comment should belong to (if not specified, the user’s current groups are used)nostrings
labelsComma-separated list of label values – comment must have all (not recommended for filtering large data sets)nostrings
pageThe page to loadnointeger1
pagesizeThe number of results per pagenointeger1000
pathsThe context URI paths for the comments – MUST be URL encoded (comma-separated list with optional * suffix)nostrings
projectReturn only discussions from the current user's groups that are under this project (only if groups not specified)nostring
titleThe title of the comments (optional wildcard * suffix, use ** to escape)nostring
typeThe type of the comments (optional wildcard * suffix, use ** to escape)nostring
typesComma-separated list of types the comment can have (empty string means no type)nostrings

Permission

This service can only be invoked by the member or an administrator. If the parameter emails is set to all, the permission is restricted to administrator only.

The other restriction is that the groups parameter can only list groups that have public access or the current user is a guest or higher.

Response

The output has the following format:

<discussions>
  <discussion id="123" 
              title="My thread"
             [replycount="1"
              lastcommentid="234" 
              lastcommentdate="2012-08-20T14:27:48+10:00"]>
    <uri id="789"> ... </uri>
    <locator fragment="2"/>
    <comment id="234" 
             contentrole="File Attachment" 
             created="2012-08-20T14:27:48+10:00">
      <title>My thread</title>
      <content type="text/plain">Some text</content>
      <attachment>
        <uri id="189"> ... </uri>
      </attachment>
      <attachment fragment="5">
        <uri id="289"> ... </uri>
      </attachment>
    </comment>
  </discussion>
  <discussion id="100"> ... </discussion>
</discussions>

The @replycount , @lastcommentid and @lastcommentdate are only included and @title is from the last comment, if the comments parameter is last, all or archive, otherwise @title is from the first comment.

Error Handling

0x1303Context ‘group’ cannot be used with 'paths' parameter
0x1306The Group is invalid or not accessible
0x1312The createdafter or createdbefore date is invalid
0x1313The author is invalid
Created on , last edited on