beehiiv Developer Documentation

Delete or Archive a post. Any post that has been confirmed will have it’s status changed to archived. Posts in the draft status will be permanently deleted.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

publicationIdstringRequiredformat: "^(pub_[0-9a-fA-F\-]+)$"

The prefixed ID of the publication object

postIdstringRequiredformat: "^(post_[0-9a-fA-F\-]+)$"

The prefixed ID of the post object

Response

No Content

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

$	curl -X DELETE https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/posts/post_00000000-0000-0000-0000-000000000000 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"id": "post_9f8b7c6d-1234-4a56-8e9f-0a1b2c3d4e5f",
3	"publicationId": "pub_1a2b3c4d-5678-90ab-cdef-1234567890ab",
4	"status": "archived",
5	"deletedAt": "2024-06-10T11:45:00Z",
6	"message": "Post has been successfully archived."
7	}