commenting_mode replaces is_comments_disabled

Emails get a three-valued commenting mode instead of a boolean

December 30, 2024
Breaking API change

This is a backwards-incompatible change to Buttondown's API. Pinning your newsletter or request to an older API version keeps the previous behavior where a version was cut for it.

Breaking change: we've unshipped the is_comments_disabled field from emails, and replaced it with a more flexible commenting_mode field.

The commenting_mode field is now a string that can be one of the following values:

  • "enabled": comments are enabled
  • "disabled": comments are disabled
  • "enabled_for_paid_subscribers": comments are enabled, but only for paid subscribers
Buttondown is the last email platform you’ll switch to.