Delete a comment
DELETE/api/v1/retro/boards/{boardID}/cards/{cardID}/comments/{commentID}
Deletes a comment. The caller may delete their own comments; deleting
someone else's needs retro:board:write as well. The board must be
active.
Requires the retro:card:write scope.
Authorization
Parameters
Path parameters
boardIDstring requiredThe board's ID.cardIDstring requiredThe card's ID.commentIDstring requiredThe comment's ID.
Responses
204
The comment was deleted.
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
successbooleanSent by Retro itself; refusals before the request reaches Retro (401, 429) carry onlyerror.errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
403
The key lacks the scope, or the comment is someone else's and the key lacks retro:board:write (FORBIDDEN).
successbooleanSent by Retro itself; refusals before the request reaches Retro (401, 429) carry onlyerror.errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
404
The board is not one the caller can see (NOT_FOUND), or the comment is not on it (COMMENT_NOT_FOUND).
successbooleanSent by Retro itself; refusals before the request reaches Retro (401, 429) carry onlyerror.errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
409
The board is closed and its content cannot change (BOARD_CLOSED). Reopen it first.
successbooleanSent by Retro itself; refusals before the request reaches Retro (401, 429) carry onlyerror.errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
429
Too many requests (RATE_LIMITED). Wait for Retry-After seconds.
Retry-AfterintegerSeconds to wait before retrying.
successbooleanSent by Retro itself; refusals before the request reaches Retro (401, 429) carry onlyerror.errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
successbooleanSent by Retro itself; refusals before the request reaches Retro (401, 429) carry onlyerror.errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
Example request
curl -X DELETE 'https://evohub.io/api/v1/retro/boards/brd_3f9a1c7e2b8d4a60/cards/crd_8d0c4b6e1a9f2357/comments/cmt_4e6a8c0b2d1f3957' \
-H 'Authorization: Bearer <TOKEN>'
