Skip to main content
Comments

Delete a comment

Deletes a comment by its unique identifier.

DELETE
/v2/comments/{id}

Deletion Behavior

  • Comments with replies: Soft delete

    • Content is replaced with "[deleted]"
    • Author information is anonymized
    • Comment remains visible to maintain conversation context
    • Votes and scores are reset to 0
  • Comments without replies: Hard delete

    • Comment is permanently removed from the database
    • All associated data is deleted

Permissions

  • Comment authors can delete their own comments
  • Admins can delete any comment (subject to permissions)
  • Lite seat admins can only delete their own comments
  • Non-authors require manage_comments or manage_comments_private permission

Response

Returns a deletion confirmation:

{
  "id": "507f1f77bcf86cd799439011",
  "object": "comment",
  "deleted": true
}

Errors

  • 400 - Invalid comment ID format
  • 403 - Not authorized to delete this comment
  • 404 - Comment not found or doesn't belong to your organization
Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

idstringrequired

Comment unique identifier

Example: 507f1f77bcf86cd799439011
Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

deletedenum<boolean>required

Indicates the resource was deleted

Available options: true
Example: true
idstringrequired

Unique identifier of the deleted comment

Example: 507f1f77bcf86cd799439011
objectenum<string>required

Object type identifier

Available options: comment
Example: comment