1. Posts
swonkie.dev
  • Introduction
  • 🆕 MCP Server
  • Changelog
  • Quick Start
  • Social Networks
    • Instagram v2
    • Google My Business
    • YouTube
    • X (Twitter)
    • Threads
    • Instagram
    • LinkedIn
    • TikTok
    • Facebook
  • ✨ Andie
    • Generate an Image
      POST
  • Search
    • Search Profiles
      GET
  • Profiles
    • My Profiles
      GET
    • Competitors
      GET
  • Competitors
    • Add Competitor
    • Delete Competitor
  • Insights
    • Getting Started
    • My Profile Insights Metrics
    • My Profile Insights
    • My Profile Insights Posts
    • Competitor Insights Metrics
    • Competitor Insights
    • Competitor Insights Posts
  • Posts
    • Getting Started
    • Limits by Social Network
    • 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
    • Create a Label
  • Media
    • Get a Media
    • Create a Media
    • Upload File to Media
    • Confirm Uploaded Media
    • Delete a Media
    • Create a Media from URL
  • 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
Bodyapplication/json

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