Deal Comments

Delete a comment on a deal

DELETE/deals/{deal_id}/comments/{id}

Deletes the comment and every reply to it, and returns 204. Any token holding the scope can delete, not only the author. It can't be undone and has no dry run. Emits one deal_comment.deleted for the comment and none for its replies, and sends nothing else; a subscriber drops the replies with the comment. Write the comment again with POST /deals/{deal_id}/comments.

Path parameters

  • deal_idstring (uuid)Required#

    The deal's id, a uuid. An unknown deal, or one the token can't see, returns 404.

  • idstring (uuid)Required#

    The comment's id.

Responses

204

The comment and its replies were deleted.

401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl -X DELETE https://your-org-domain/kong/core/api/v2/deals/{deal_id}/comments/{id}\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"