Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Warning

Requirements

  • Authentication: Bearer API token

  • Scope: posts

  • Headers:

    • Authorization: Bearer-API YOUR_API_KEY

    • Publer-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

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
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

delete/posts
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: posts

  • Headers:

    • Authorization: Bearer-API YOUR_API_KEY

    • Publer-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

Parameter
In
Type
Required
Description

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/posts with post_ids.

  • If the post was already removed on the network, it is still marked published_deleted and no error is returned.

  • Calling it on a post that is already published_deleted does nothing and returns no error.

  • Editors cannot delete posts that were published through an approval workflow (403).

Last updated

Was this helpful?