Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

scope

The scope object. The segment must be within the scope.

NOTE: This method does not support the Global Search scope.

Mandatory
cty

Type of comments to retrieve: "s": Segment level comment. "d": Document level comment.

Mandatory
queryAn optional query object. This allows to constrain the segments to fetch comments for.Optional
localesOptional filter on languages of comments. If null then comments will be retrieved for all scope languages.Optional
txt

Optional text filter.

Optional
catOptionally, the comments category. Defines the category (a name) as well as visual style.Optional
uidOptional filter on the user who added/updated the comment.Optional
tskOptional filter on the task code stored with a comment if the comment was added by a worker in the framework of a job.Optional
ascOptional sort order. False (default) = sort with most recent comments on top. True = Oldest comments on top.
skipUsed for pagination. 0 = get comments from the start. If not specified, value will be 0.Optional
takeUsed for pagination. Number of pages to retrieve. If not set, value will be 30.Optional
knownPersons

Optional array of person/user ids for which we do not need name and company, since we already have this information.

Try to provide the person ids if you already have details as this will speed up performance.

Optional
solvedOptional boolean property to filter the comments by its solved status. (false) means to get the non-solved comments. (true) means to get the solved comments. (null or not sending the property) means to get all the commentsOptional


Pagination: The skip/take values do not necessarily count actual comments. They are system internal numbers only.

...