Skip to main content
DELETE
/
comments
/
:id
Delete Comment
curl --request DELETE \
  --url https://api.example.com/comments/:id
{
  "id": "<string>",
  "body": "<string>",
  "filePath": "<string>",
  "lineNumber": 123,
  "pullRequestId": "<string>",
  "userId": 123,
  "parentCommentId": "<string>",
  "resolved": true,
  "createdAt": "<string>",
  "updatedAt": "<string>"
}
Delete a comment from a pull request. Deleting a parent comment will also delete all its threaded replies.

Authentication

This endpoint requires JWT authentication. Include the JWT token in the Authorization header:
Authorization: Bearer <token>

Path Parameters

id
string
required
The ID of the comment to delete

Response

id
string
The unique identifier of the deleted comment
body
string
The content of the deleted comment
filePath
string
The file path where the comment was made
lineNumber
number
The line number in the file
pullRequestId
string
The ID of the pull request
userId
number
The ID of the user who created the comment
parentCommentId
string
The ID of the parent comment if this was a reply
resolved
boolean
Whether this comment thread was resolved
createdAt
string
ISO 8601 timestamp of when the comment was created
updatedAt
string
ISO 8601 timestamp of when the comment was last updated

Example

curl -X DELETE https://api.diffy.com/comments/1 \
  -H "Authorization: Bearer <token>"

Response

{
  "id": "1",
  "body": "This function could be optimized by caching the result",
  "filePath": "src/utils/processor.ts",
  "lineNumber": 42,
  "pullRequestId": "123456789",
  "userId": 5,
  "parentCommentId": null,
  "resolved": false,
  "createdAt": "2026-03-01T10:30:00Z",
  "updatedAt": "2026-03-01T10:30:00Z"
}

Build docs developers (and LLMs) love