Skip to main content
DELETE
Delete Blog Post via Write API
Delete an existing blog post using a soft delete operation that marks the post as deleted, removes it from public visibility and reassigns its slug. The post’s content and metadata are otherwise kept in the system. Soft Delete Behavior: The post is marked as deleted in the system and will no longer appear in blog listings, search results, RSS feeds, or other public endpoints. Content and metadata are otherwise preserved, but the post’s slug is reassigned to a generated value (so the original slug is immediately free for a new post). Recovering the original slug would require support to restore it manually. Localization: Use the locale query parameter to specify which locale variant to delete (e.g. ?locale=es). When omitted, the post’s current locale is used. If the specified locale variant does not exist, a 404 Not Found response is returned. Access Control: You can only delete blog posts that belong to your organization. Attempting to delete posts from other organizations will result in a 404 Not Found response, ensuring proper data isolation and security.

Authorizations

Authorization
string
header
required

Write-enabled API token required for creating content.

The API token you use for reading from the ButterCMS API will not allow you to create content in the API. For this you will need to use a different write-enabled token. Write API access is a paid add-on for Advanced and Professional plans, enabled from the Billing page of your account. It isn't offered on Basic plans.

Set the Authorization header to Token your_write_api_token. The ?auth_token= query parameter also works for write requests, but a header is safer because URLs are more likely to be logged.

Example: Authorization: Token abc123def456

Your write-enabled token should never be used anywhere it would be exposed, e.g. in client-side JavaScript.

Path Parameters

slug
string
required

The slug of the blog post to delete.

Maximum string length: 100

Query Parameters

locale
string

Delete this locale variant of the post (e.g. en, es). When omitted, deletes the post in its current locale. Returns 404 if the locale variant does not exist.

Maximum string length: 10

Response

No Content - Blog Post Successfully Deleted

The blog post has been successfully deleted (soft delete). The response body is empty.

Note: This is a soft delete operation. The post is marked as deleted but not physically removed from the system.