Skip to main content

Comment - Delete

NOT Part of Day 1 Release

To hit our deadline, we cut this from the scope. We will build this endpoint after we build the Day 1 release endpoints.

Purpose​

To delete a Comment resource which originated from your internal system using the ID of the comment from your internal system. You can NOT delete comments that originate on the Incentify system.

Request​

Endpoint

DELETE /comment/{internal_comment_id}

Authentication

Include your API Key within the x-api-key header as described here.

Parameters

There are no parameters for this method. The internal_comment_id should be provided in the final path segment of the URI.

Request Body

Do not provide a request body when calling this method.

Successful Response​

If successful, this method returns an http code of 204 and an empty response body:

Response Body

{
}

Error Response​

If the request has invalid fields/values, this method returns an http code of 400 and response body with the following structure:

Error Response Body

{
"code":400,
"success":false,
"data": {},
"errors": [
"text describing error here"
]
}

Properties

The following table defines the properties that appear in this resource:

KeyTypeDefinition
codeintegerHTTP Status Code (ie; 204, 403, etc).
successbooleanEither true (success) or false (fail).
errors[string, string, string...]If the request fails, this will contain information about the error.