headless lms

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.