Collections-Items-Folders-Comments

Number of APIs: 4

1. Get a folder's comments

GET {{baseUrl}}/collections/{{collectionUid}}/folders/{{folderUid}}/comments

Gets all comments left by users in a folder.

---

2. Create a folder comment

POST {{baseUrl}}/collections/{{collectionUid}}/folders/{{folderUid}}/comments

Creates a comment on a folder. Include the following in request body:

• body — (Required) A string that contains the comment.

• tags — An object that contains information about users tagged in the body comment. Include the following in this object:

  • userName — (Required) An object that contains information about the tagged user. The object's name is the user's Qodex username. For example, @user-Qodex. Include the following in this object:

    • type — (Required) A string that contains the user value.
    • id — (Required) An integer that contains the user's ID.

Note:

This endpoint accepts a max of 10,000 characters.

---

3. Update a folder's comment

PUT {{baseUrl}}/collections/{{collectionUid}}/folders/{{folderUid}}/comments/{{commentId}}

Updates a comment on a folder. Include the following in request body:

• body — (Required) A string that contains the comment.

• tags — An object that contains information about users tagged in the body comment. Include the following in this object:

  • userName — (Required) An object that contains information about the tagged user. The object's name is the user's Qodex username. For example, @user-Qodex. Include the following in this object:

    • type — (Required) A string that contains the user value.
    • id — (Required) An integer that contains the user's ID.

Note:

This endpoint accepts a max of 10,000 characters.

---

4. Delete a folder's comment

DELETE {{baseUrl}}/collections/{{collectionUid}}/folders/{{folderUid}}/comments/{{commentId}}

Deletes a comment from a folder. On success, this returns an HTTP 204 No Content response.

Note:

Deleting the first comment of a thread deletes all the comments in the thread.

---