InsightComments

Delete insight comment

Changed on

Delete a comment on an insight.

Only the comment author can delete their own comments. Deleted comments can be restored for up to 30 days.

Returns the deleted comment.

🚧 Permissions

Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

Required scope: comment:delete

delete/v1/insights/{insight_id}/comments/{comment_id}

Request

  • Base URL
    https://dovetail.com/api
  • URL
    https://dovetail.com/api/v1/insights/{insight_id}/comments/{comment_id}
  • Auth
    HTTP bearer

Path parameters

insight_idstring required

Unique identifier of the insight.

comment_idstring required

Unique identifier of the comment.

Response

200

Changes

    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status