Deleting Posts

Remove one or multiple posts of any state from your workspace. This endpoint enforces role-based permissions and state-specific restrictions.

Warning

If the post_ids query parameter is omitted, this endpoint will delete all non-published posts in the workspace that you have permission to delete. This includes:

• Scheduled posts
• Draft posts
• Auto-scheduled posts
• Recycle posts
• Recurring posts
• Pending posts
• Other unpublished post states

Published posts are never deleted when post_ids is omitted.

Use this operation with caution, as it performs a bulk deletion.

Requirements

• Authentication: Bearer API token
• Scope: posts
• Headers:

  • Authorization: Bearer-API YOUR_API_KEY
  • Publer-Workspace-Id: YOUR_WORKSPACE_ID

Endpoint

DELETE /api/v1/posts

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

Delete Multiple Posts

delete

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.

Authorizations

BearerApiAuth

AuthorizationstringRequired

API key authentication. Format: "Bearer-API YOUR_API_KEY"

Query parameters

post_idsstring[]Required

Array of post IDs to delete. Can include both MongoDB ObjectIDs and PostgreSQL IDs.

Header parameters

Publer-Workspace-IdstringRequired

ID of the workspace containing the posts

Responses

200

Posts deleted successfully

application/json

deleted_idsstring[]Optional

Array of IDs of successfully deleted posts

401

Unauthorized

application/json

403

Permission denied or missing required scope

application/json

delete/posts

HTTPcURLJavaScriptPython

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"
  ]
}

Related Resources

• List Posts API - Retrieve and filter posts
• Update Posts API - Modify existing posts