Discussion
Learner comments, replies, reactions and moderation
Read an activity's comments
For anyone who can open the course: through a grant, or with `courses:read` on it. Returns the activity's resolved comment settings with the comments; removed comments keep their place without their body.
Post a comment or reply on an activity
For anyone who can open the course, while discussion is on for the activity (403 otherwise). Lands pending when the course requires review and you do not hold `courses:moderate` on it. Replies nest one level and need threading on.
Revise your own comment
Author only; not even a moderator may revise it. Discussion must be open where the comment is, and a removed comment cannot be revised.
Delete your comment, or one you moderate
The author can delete their own comment; anyone else needs `communities:moderate` on the community for a post comment, or `courses:moderate` on the course for a lesson comment. The comment is marked removed and keeps its place in the thread. Deleting a removed comment returns it unchanged.
Withdraw your reaction from a comment
For anyone who can read the comment. Returns the new counts.
Set your reaction on a comment
For anyone who can read the comment, while reactions are on where it is (403 otherwise). Replaces any reaction you already had and returns the new counts.
Flag a comment for the moderators
For anyone who can read the comment. Flagging it again while your flag is open returns that flag.
Dismiss the open flags on a comment in a space you moderate
Needs `courses:moderate` on the course for an activity comment, or `communities:moderate` on the community for a post comment. Closes every open flag and leaves the comment up.
Restore a removed comment where you moderate
Needs `courses:moderate` on the course for an activity comment, or `communities:moderate` on the community for a post comment. Publishes the comment again; a comment that is not removed is returned unchanged.
Publish a comment awaiting review where you moderate
Needs `courses:moderate` on the course for an activity comment, or `communities:moderate` on the community for a post comment. 403 when the comment is not awaiting review.
List course comments for moderation
Requires `courses:moderate`. Comments on the activities of the courses you moderate, filtered by course, activity, author, status or open reports; each row carries the author's email and the open reports.
Publish a course comment
Needs `courses:moderate` on the course. Approves a pending comment or restores a removed one; a published comment is returned unchanged.
Remove a course comment
Needs `courses:moderate` on the course, unless it is your own comment. Hides the comment and resolves its open reports as `removed`. Removing a removed comment returns it unchanged.
Dismiss every open report on a course comment
Needs `courses:moderate` on the course. The comment stays up.
Reply to a course comment from the moderation queue
Requires `courses:moderate`. Needed on the comment's course. Replies nest one level: answering a reply attaches to its root comment.