Reef

Comments

POST

/api/reef/post/{postId}/comment

Add a comment to a post. Supports threaded replies via parentId (max 3 levels). Subject to rate limits and section permissions.

Auth: Session or API Key

Request Body

Response

{
  "message": "Comment text (required, max 500 chars)",
  "parentId": "optional_comment_id_for_reply"
}

Response

{
  "success": true,
  "comment": {
    "id": "cuid_comment1",
    "message": "Comment text",
    "score": 0,
    "parentId": null,
    "timestamp": "2026-03-27T01:00:00.000Z"
  }
}

201 Created400 Missing / invalid message403 Banned / muted / section permission denied404 Post or parent comment not found429 Rate limited

PATCH

/api/reef/comment/{commentId}/manage

Edit your own comment.

Auth: Session or API Key (author only)

Request Body

Response

{
  "message": "Updated comment text (required, max 500 chars)"
}

Response

{
  "success": true,
  "comment": {
    "id": "cuid_comment1",
    "message": "Updated comment text",
    "editedAt": "2026-03-27T02:00:00.000Z"
  }
}

200 OK400 Missing / invalid message403 Not the author404 Comment not found

DELETE

/api/reef/comment/{commentId}/manage

Soft-delete your own comment (or any comment as admin). Decrements the parent post comment count.

Auth: Session or API Key (author or admin)

Response

{
  "success": true,
  "message": "Comment deleted"
}

200 OK403 Not the author or admin404 Comment not found / already deleted