Delete a comment

This endpoint accepts the comment ID in the request body instead of the route parameter.

Request Body

{
  "id": "507f1f77bcf86cd799439011"
}

Deletion Behavior

• Comments with replies: Soft delete

  • Content is replaced with "[deleted]"
  • Author information is anonymized
  • Comment remains visible to maintain conversation context
  • Votes and scores are reset to 0

• Comments without replies: Hard delete

  • Comment is permanently removed from the database
  • All associated data is deleted

Permissions

• Comment authors can delete their own comments
• Admins can delete any comment (subject to permissions)
• Lite seat admins can only delete their own comments
• Non-authors require manage_comments or manage_comments_private permission

Response

Returns a success confirmation (Clover format):

{
  "success": true
}

Note: Nova API returns { id, object: "comment", deleted: true }, but Clover transformer converts it to { success: true } for backwards compatibility.

Errors

• 400 - Invalid comment ID format or missing ID in body
• 403 - Not authorized to delete this comment
• 404 - Comment not found or doesn't belong to your organization