Get a feed of my file's comments

Get a feed of my file's comments
Get a feed that lists all of the comments associated with one of your files.
Table 1. Atom API request details

Resource Description
/basic/api/myuserlibrary/document/{document-id}/feed?category=comment A feed of comments associated with one of your files.

{document-id} is the value of the <td:uuid> or <td:label> elements in the file's Atom entry document.
Use one or more of the input parameters to narrow the search. Separate multiple parameters with an ampersand (&).
Table 2. Input parameters

Parameter Description
acls Specifies whether or not the permissions for each user should be displayed for each entry in the returned feed. This parameter takes a Boolean value of either true or false. By default, the permission information is not returned.
category
Note: This parameter is required.
Resource type to include in the response. This parameter should always be set to comment. If you do not specify a category, comment is returned.
commentId Specifies the relative returned comments. If provided, page and sI are ignored.
identifier Indicates how the document is identified in the {document-id} variable segment of the web address. By default, look up is performed with the expectation that the URL contains the value from the <td:uuid> element of a file Atom entry. Options are uuid and label. Specify label if the URL instead contains the value from the <td:label> element of a file Atom entry.
page Page number. Specifies the page to be returned assuming a constant page size. The default value is 1.
pageSize Page size. Specifies the number of items to include in a paged request. The default value is 10. Specify the page size in increments of ten.
sI Start index. Specifies the start index (as a number) in the collection from which the results should be returned. This parameter is ignored if a page parameter is provided.
sortBy String. Specifies what to sort the returned entries by. Options are:
created
Organize the entries by comment creation date.

modified
Organize the entries by comment modification date.

published
Organize the entries by comment publication date.

updated
Organize the entries by the date on which the comment was updated.

The default value for this parameter is modified.
sortOrder String. Defines the order in which to sort the results. Options are:
asc
Ascending.

desc
Descending.

If a value is specified for the sortBy parameter, but none is specified for this parameter, then this parameter defaults to asc. If neither is specified, this parameter defaults to desc.

Parent topic
Getting Files feeds

});

+
Search Tips | Advanced Search

Resource	Description
/basic/api/myuserlibrary/document/{document-id}/feed?category=comment	A feed of comments associated with one of your files.

Parameter	Description
acls	Specifies whether or not the permissions for each user should be displayed for each entry in the returned feed. This parameter takes a Boolean value of either true or false. By default, the permission information is not returned.
category Note: This parameter is required.	Resource type to include in the response. This parameter should always be set to comment. If you do not specify a category, comment is returned.
commentId	Specifies the relative returned comments. If provided, page and sI are ignored.
identifier	Indicates how the document is identified in the {document-id} variable segment of the web address. By default, look up is performed with the expectation that the URL contains the value from the <td:uuid> element of a file Atom entry. Options are uuid and label. Specify label if the URL instead contains the value from the <td:label> element of a file Atom entry.
page	Page number. Specifies the page to be returned assuming a constant page size. The default value is 1.
pageSize	Page size. Specifies the number of items to include in a paged request. The default value is 10. Specify the page size in increments of ten.
sI	Start index. Specifies the start index (as a number) in the collection from which the results should be returned. This parameter is ignored if a page parameter is provided.
sortBy	String. Specifies what to sort the returned entries by. Options are: created Organize the entries by comment creation date. modified Organize the entries by comment modification date. published Organize the entries by comment publication date. updated Organize the entries by the date on which the comment was updated. The default value for this parameter is modified.
sortOrder	String. Defines the order in which to sort the results. Options are: asc Ascending. desc Descending. If a value is specified for the sortBy parameter, but none is specified for this parameter, then this parameter defaults to asc. If neither is specified, this parameter defaults to desc.