Deleting Posts

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

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.

Query Parameters

Parameter	Type	Required	Description
post_ids	array	Yes	Array of post IDs to delete

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

• 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

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