Remove one or multiple posts—of any state—from your workspace. This endpoint enforces role-based permissions and state-specific restrictions.
Authentication: Bearer API token
Scope: posts
Headers:
Authorization: Bearer-API YOUR_API_KEY
Publer-Workspace-Id: YOUR_WORKSPACE_ID
DELETE /api/v1/postsDeletes one or more posts based on the provided IDs.
Parameter
Type
Required
Description
post_ids
array
Yes
Array of post IDs to delete
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
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.
List Posts API - Retrieve and filter posts
Update Posts API - Modify existing posts
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.
Array of post IDs to delete. Can include both MongoDB ObjectIDs and PostgreSQL IDs.
ID of the workspace containing the posts
DELETE /api/v1/posts HTTP/1.1
Host: app.publer.com
Authorization: YOUR_API_KEY
Accept: */*
{
"deleted_ids": [
"text"
]
}