Delete a comment
Removes a comment. Only its author may.
DELETE
/v1/comments/:id
Permission
The key must be granted docs.comments.write
A key without it gets 403 insufficient_scope, with the missing permission named in details.
Only the author may. A soft delete upstream, so a thread keeps its shape.
Path parameters
| Field | Type | Description |
|---|---|---|
id required |
string | The comment to remove. |
Request
curl https://api.veruapis.com/v1/comments/:id \
-X DELETE \
-H "Authorization: Bearer vak_live_..." \
-H "Idempotency-Key: $(uuidgen)"Idempotency-Key is required on every write. Retrying with the same key returns the original response rather than repeating the operation, so a timeout is something you retry rather than something you investigate.
Response
Answers 204.
{
"data": 204 No Content,
"meta": { "request_id": "req_01j8z9...", "timestamp": "2026-09-02T10:00:00Z" }
}
Worth knowing
Only the author may. A soft delete, so the thread keeps its shape.
Errors
Every failure uses the same shape, with a stable string code you can branch on. See the error reference.
Related
- POST Copy a document
- POST Post a comment
- POST Create a document
- DELETE Delete a document
- GET Get a document
- GET List comments
- GET List documents
- POST Restore a document
- PATCH Edit or resolve a comment
- PATCH Update a document