API EndpointsCommentsDelete Comment

Delete Comment

Endpoint

URL: /:projectId/comments/:commentId

Method: DELETE

Authentication Required: Yes


Description

Deletes a comment from the project.

  • Only the original author or a master client can delete the comment.
  • Decreases the author’s reputation.
  • Recursively updates all replies to mark their parent as deleted (parentDeletedAt).

Request

Path Parameters

ParameterTypeRequiredDescription
commentIdstringYesThe ID of the comment to delete.

Headers

HeaderTypeRequiredDescription
AuthorizationstringYesBearer token for authenticated users.

Response

Success Response (204 No Content)

Comment was successfully deleted. No content is returned.


Error Responses

Missing Comment ID (400 Bad Request)

{
  "error": "Missing comment ID",
  "code": "comment/missing-comment-id"
}

Not Found (404 Not Found)

{
  "error": "Comment not found",
  "code": "comment/not-found"
}

Not Authorized (403 Forbidden)

{
  "error": "You do not have permission to delete this comment.",
  "code": "comment/not-authorized"
}

Server Error (500 Internal Server Error)

{
  "error": "Server error",
  "code": "comment/server-error",
  "details": "[error message]"
}

Notes

  • Only the comment’s author or a master client may delete the comment.
  • Upon deletion, the comment author’s reputation is reduced.
  • All child replies have their parentDeletedAt timestamp updated recursively.
  • Replies are not deleted — they are marked as having a deleted parent.