1. Posts
swonkie.dev
  • Introduction
  • Quick Start
  • Changelog
  • Social Networks
    • Facebook
    • Instagram
    • LinkedIn
    • TikTok
    • Threads
  • Profiles
    • My Profiles
      GET
    • Competitors
      GET
  • Insights
    • Getting Started
    • My Profile Insights
      GET
    • My Profile Insights Posts
      GET
    • Competitor Insights
      GET
    • Competitor Insights Posts
      GET
  • Posts
    • Getting Started
    • List Posts
      GET
    • Get a Post
      GET
    • Create a Post
      POST
    • Update a Post
      PUT
    • Validate a Post
      GET
    • Delete a Post
      DELETE
    • Change Post Stage
      PATCH
  • Labels
    • Getting Started
    • List Labels
      GET
    • Create a Label
      POST
  • Media
    • Get a Media
    • Create a Media
    • Upload File to Media
    • Confirm Uploaded Media
    • Delete a Media
  • Examples
    • Publish
Back to Home
Back to Home
Login
  1. Posts

Delete a Post

DELETE
/posts/{postId}
Deletes a post from your workspace. This action is permanent and cannot be undone. The post must belong to your workspace and must not be in certain protected stages (e.g., currently publishing). Once deleted, all associated data including captions, media assignments, labels, and network-specific configurations will be removed.

Notes#

This action is permanent and cannot be undone.
The post must belong to your workspace, otherwise a 404 error will be returned.
Deleting a post does not delete the media files from your media library - they remain available for use in other posts.
Deleting a post does not affect content already published to social networks - use each platform's native tools to remove published content.
Posts in certain stages (e.g., actively publishing) may be protected from deletion and will return an error.
All post associations (profiles, labels, media) are removed, but the underlying resources (profiles, labels, media files) remain in your workspace.

Request

Path Params

Header Params

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'https://api.swonkie.dev/v2/posts/UG9zdElkMTIzNDU2Nzg51352' \
--header 'X-API-ID: {{apiId}}' \
--header 'X-API-KEY: {{apiKey}}'
Response Response Example
{
    "success": true,
    "message": "Post deleted successfully"
}
Modified at 2026-03-11 19:13:36
Previous
Validate a Post
Next
Change Post Stage
Built with