Delete Commentedit
Deletes a Comment.
Requestedit
DELETE /api/v1/comments/{resource_type}/{resource_id}/{comment_id}
Path parametersedit
Name | Type | Required | Description |
---|---|---|---|
|
|
Y |
Id of a Comment |
|
|
Y |
Id of the Resource that a Comment belongs to. |
|
|
Y |
The kind of Resource that a Comment belongs to. Should be one of [elasticsearch, kibana, apm, appsearch, enterprisesearch, sitesearch, allocator, constructor, runner, proxy]. |
Query parametersedit
Name | Type | Required | Description |
---|---|---|---|
|
|
N |
If specified then checks for conflicts against the version stored in the persistent store (returned in 'x-cloud-resource-version' of the GET request) |
Responsesedit
-
200
-
(
EmptyResponse
) Comment deleted successfully.Headers
-
x-cloud-resource-created
(string
) - The date-time when the resource was created (ISO format relative to UTC)
-
x-cloud-resource-last-modified
(string
) - The date-time when the resource was last modified (ISO format relative to UTC)
-
x-cloud-resource-version
(string
) - The resource version, which is used to avoid update conflicts with concurrent operations
-
-
401
-
(
BasicFailedReply
) * The Comment does not belong to you. (code:comments.unauthorised
) * Your current session does not have a user id associated with it. (code:comments.no_user_id
)Headers
-
x-cloud-error-codes
(string
; allowed values: [comments.unauthorised
,comments.no_user_id
]) - The error codes associated with the response
-
-
404
-
(
BasicFailedReply
) The Comment you want does not exist. (code:comments.comment_does_not_exist
)Headers
-
x-cloud-error-codes
(string
; allowed values: [comments.comment_does_not_exist
]) - The error codes associated with the response
-
-
409
-
(
BasicFailedReply
) The version you sent does not match the persisted version. (code:comments.version_conflict
)Headers
-
x-cloud-error-codes
(string
; allowed values: [comments.version_conflict
]) - The error codes associated with the response
-
To perform this operation, you must be authenticated by means of one of the following methods: apiKey, basicAuth.
Request exampleedit
curl -XDELETE {{hostname}}/api/v1/comments/{resource_type}/{resource_id}/{comment_id} \ -H "Authorization: ApiKey $ECE_API_KEY"