1. Media
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
      POST
    • Delete Competitor
      DELETE
  • 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 a Post
    • Create a Post
    • Update a Post
    • Validate a Post
    • Delete a Post
    • Change Post Stage
  • Labels
    • Getting Started
    • List Labels
    • Create a Label
  • Media
    • Get a Media
      GET
    • Create a Media
      POST
    • Upload File to Media
      PUT
    • Confirm Uploaded Media
      PATCH
    • Delete a Media
      DELETE
    • Create a Media from URL
      POST
  • Examples
    • Publish
Back to Home
Back to Home
Login
  1. Media

Delete a Media

DELETE
/media/{mediaId}
Deletes a media file from your workspace's media library. This action is permanent and cannot be undone. The media file and all its associated data (preview, metadata) will be removed from storage.
Important: The media must belong to your workspace, otherwise a 404 error will be returned. Media files that are currently being used in active posts can still be deleted, but this may affect those posts depending on whether they've already been published. Published posts will retain the media on social networks, but the reference in your system will be lost.

Notes#

This action is permanent and cannot be undone.
The media must belong to your workspace, otherwise a 404 error will be returned.
Deleting media that is currently used in posts (especially scheduled or published posts) may cause issues - ensure media is not needed before deletion.
The actual file is removed from storage, along with any generated previews/thumbnails.
If media has already been published to social networks, deleting it from your library will not remove it from those platforms.
Consider archiving media instead of deleting if you might need it in the future (though archiving is not currently available via the API).

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/media/TWVkaWFJZDk4NzY1NDMyMQ' \
--header 'X-API-ID: ' \
--header 'X-API-KEY: '
Response Response Example
{
    "success": true,
    "message": "Media deleted successfully"
}
Modified at 2026-06-19 17:25:24
Previous
Confirm Uploaded Media
Next
Create a Media from URL
Built with