Deleting Posts
Delete posts from your Publer workspace, or remove published posts from the social networks they were published to. These endpoints enforce role-based permissions and state-specific restrictions.
Requirements
Authentication: Bearer API token
Scope:
postsHeaders:
Authorization: Bearer-API YOUR_API_KEYPubler-Workspace-Id: YOUR_WORKSPACE_ID
Endpoint
Deletes one or more posts based on the provided IDs. If no post_ids are provided, all unpublished posts that you have permission to delete will be removed.
Query Parameters
Parameter
Type
Required
Description
post_ids
array
Yes
Array of post IDs to delete. If omitted, all unpublished posts (scheduled, drafts, recycle, recurring, auto-scheduled, pending, etc.) that you have permission to delete will be deleted. Published posts are excluded.
Authorization Rules
You may delete:
Posts you created
Posts in workspaces you own
Posts in workspaces where you have post action access
Private drafts: only their creator can delete
Restrictions:
Published posts requiring approval: restricted roles (e.g. editors) cannot delete
Queued posts (except reminders): cannot be deleted
Pending-state deletions trigger a notification to the creator before removal
Deletes one or multiple posts from the workspace specifying exact post IDs. Authorization rules apply to ensure users can only delete posts they have permission to delete.
API key authentication. Format: "Bearer-API YOUR_API_KEY"
Array of post IDs to delete. Can include both MongoDB ObjectIDs and PostgreSQL IDs.
ID of the workspace containing the posts
Posts deleted successfully
Array of IDs of successfully deleted posts
Unauthorized
Permission denied or missing required scope
DELETE /api/v1/posts?post_ids=text HTTP/1.1
Host: app.publer.com
Authorization: YOUR_API_KEY
Publer-Workspace-Id: text
Accept: */*
{
"deleted_ids": [
"text"
]
}Delete a Published Post
Remove a published post from the social network it was published to. The post stays in Publer, in the published_deleted state, so its history and analytics remain available.
Requirements
Authentication: Bearer API token
Scope:
postsHeaders:
Authorization: Bearer-API YOUR_API_KEYPubler-Workspace-Id: YOUR_WORKSPACE_ID
The API key's user must be the post's creator, the workspace owner, or a member with post action access.
Endpoint
Parameters
id
path
string
Yes
ID of the published post to delete
Response
The deletion runs in the background. The endpoint returns a job ID straight away:
Limitations
Some social networks restrict post deletion through their API:
Notes
Only use this endpoint on published posts. To delete scheduled, draft or other unpublished posts, use
DELETE /api/v1/postswithpost_ids.If the post was already removed on the network, it is still marked
published_deletedand no error is returned.Calling it on a post that is already
published_deleteddoes nothing and returns no error.Editors cannot delete posts that were published through an approval workflow (
403).
Related Resources
List Posts API - Retrieve and filter posts
Update Posts API - Modify existing posts
Last updated
Was this helpful?

