---
title: "Changes to Publish Email"
method: POST
path: "/emails/{id}/publish"
---

# Changes to Publish Email

`POST /emails/{id}/publish`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 43 revisions.

- **2026-10-27** `8fff9c6b1347`: 1 breaking, 2 warning, 1 info
- **2026-10-20** `bc6be78752aa`: 1 info
- **2026-09-22** `f00fce908264`: 1 warning, 1 info
- **2026-08-08** `3a702c095d22`: 1 warning, 1 info
- **2026-07-26** `fc5d382abadb`: 1 warning
- **2026-07-13** `228cc05ba97d`: 1 info

## Changes

- **2026-10-27** `8fff9c6b1347`: 1 breaking, 2 warning, 1 info
  - removed the enum value `suppressed` of the request property `status/anyOf[subschema #1: Status]/`
  - removed the request property `suppression_reason`
  - removed the optional property `suppression_reason` from the response with the `200` status
  - removed the `suppressed` enum value from the `status` response property for the response status `200`
- **2026-10-20** `bc6be78752aa`: 1 info
  - added the optional property `analytics/anyOf[subschema #1: Analytics]/attempts` to the response with the `200` status
- **2026-09-22** `f00fce908264`: 1 warning, 1 info
  - added the new `partially_sent` enum value to the `status` response property for the response status `200`
  - added the new `partially_sent` enum value to the request property `status/anyOf[subschema #1: Status]/`
- **2026-08-08** `3a702c095d22`: 1 warning, 1 info
  - added the new `archive_only` enum value to the `archival_mode` response property for the response status `200`
  - added the new `archive_only` enum value to the request property `archival_mode/anyOf[subschema #1: ArchivalMode]/`
- **2026-07-26** `fc5d382abadb`: 1 warning
  - added the new `smtp` enum value to the `source` response property for the response status `200`
- **2026-07-13** `228cc05ba97d`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/buttondown/apis/buttondown-api/docs/emails/:id/publish/post.md) - [API](https://skmtc.dev/buttondown/apis/buttondown-api.md) - [Page](https://skmtc.dev/buttondown/apis/buttondown-api/changes/emails/:id/publish/post)
