3a702c095d22

latestOpenAPI 3.1.0MIT2026-08-08133230925.7 KB

Comments

Update Comment

Update a comment's status. Only the newsletter owner can call this.

patch/comments/{id}

Path parameters

idstring required

Request body

status'active' | 'spammy' required

The new status for the comment. Use 'active' to approve or 'spammy' to mark as spam.

Response

idstring required

A unique TypeID associated with the object.

creation_datestring date-time required

The date and time at which the object was first created.

email_idstring required

The ID of the email this comment is attached to.

subscriber_idstring nullable

The ID of the subscriber who posted the comment, or null if posted by the newsletter author.

parent_idstring nullable

The ID of the parent comment, if this comment is a reply to another comment.

textstring required

The text content of the comment.

status'pending' | 'active' | 'spammy' required

An enumeration.

Example response

{
  "subscriber": {
    "country": "US",
    "email_address": "telemachus@buttondown.email",
    "delivered_count": 12,
    "open_count": 7,
    "clicked_count": 3,
    "open_rate": 0.5833,
    "click_rate": 0.25
  },
  "email": {
    "slug": "welcome-to-the-newsletter"
  }
}