Skip to main content
DELETE
https://api.ayrshare.com/api
/
post
curl \
-H "Authorization: Bearer API Key" \
-H 'Content-Type: application/json' \
-d '{"id": "Post ID"}' \
-X DELETE https://api.ayrshare.com/api/post

{
    "twitter": {
        "action": "delete",
        "status": "success",
        "id": "1288900099663775749" // Twitter Social Post ID
    },
    "facebook": {
        "action": "delete",
        "status": "success",
        "id": "104920007983682_108683297607743" // Facebook Social PostID
    },
    "status": "success"
}
Available on plan.
Delete a post using the post ID returned from the /post endpoint. You can delete both published and scheduled posts, but there are some differences based on the social network platform:
  • Scheduled posts can be deleted for all social networks platforms.
  • Published posts can be deleted for all social networks platforms except for Instagram and TikTok. Instagram and TikTok do not provide API support for deleting published posts. If you need to delete a published post on these platforms, you must do so manually using their respective mobile apps.
  • Facebook does not permit deleting image stories via their API (video stories can be deleted). If you need to delete an image story, please go to the Facebook mobile app and perform the deletion manually.
Instagram and TikTok do not support delete via their APIs. Please go to the Instagram or TikTok mobile apps to delete the posts.Facebook does not support image story deletion via its API. Please go to the Facebook mobile app to delete stories.

​
Header Parameters

​
Authorization
string
required
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
​
Profile-Key
string
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

​
Body Parameters

​
id
string
required
Ayrshare Post ID of the post to delete.Not required if bulk or deleteAllScheduled parameter sent.If the post is scheduled and still pending, the scheduled posts will be deleted and not sent to the networks.If the post has already been sent to the networks, the post will be deleted from the networks.
​
bulk
array
Array of Strings post Ids to bulk delete.Required if id or deleteAllScheduled parameter not sent.
​
deleteAllScheduled
boolean
default:false
If true will delete all scheduled posts still in a pending state, i.e. posts that have not yet been published to the networks, for the User Profile.The id or bulk parameters are ignored if set to true.
This will delete all scheduled posts, so be sure to use this with caution.
​
markManualDeleted
boolean
default:false
If true, the post will mark as deleted in Ayrshare and Ayrshare will not try to delete the post at the networks.A common use case for this is when the post was manually deleted at the networks and you want to mark it as deleted in Ayrshare.Prior to marking the post as deleted, please ensure that the post was already manually deleted on the social networks.
curl \
-H "Authorization: Bearer API Key" \
-H 'Content-Type: application/json' \
-d '{"id": "Post ID"}' \
-X DELETE https://api.ayrshare.com/api/post

{
    "twitter": {
        "action": "delete",
        "status": "success",
        "id": "1288900099663775749" // Twitter Social Post ID
    },
    "facebook": {
        "action": "delete",
        "status": "success",
        "id": "104920007983682_108683297607743" // Facebook Social PostID
    },
    "status": "success"
}