Discard a Social Post

Overview#

Permanently deletes a post that never reached a platform. That covers drafts, scheduled posts not yet fired, posts that failed outright, and posts still in flight that have not landed anywhere. Where the post is still cancellable on the platform queue, it is cancelled there too.

The one thing you cannot discard is a post that is already live on at least one account — including a partial post, where some accounts succeeded and others failed. Deleting those would destroy your only record of something public. Remove those on the platform itself.

Check is_discardable on the post rather than guessing from status: is_editable and is_discardable are different tests. A failed post can be discarded but not edited.

https://api.orshot.com/v1/social/posts/{postId}

Request#

await fetch("https://api.orshot.com/v1/social/posts/512", {
  method: "DELETE",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

{
  "data": {
    "success": true
  }
}

Still discarding (202)#

When the platform is slow to confirm the cancel, you get 202. The discard finishes in the background. Check the post in a minute. It leaves the list once the platform confirms. If the cancel fails, the post shows why in error_message.

{
  "message": "Discarding. Check the post in a minute: it leaves the list once the platform confirms the cancel, or shows why if the cancel failed.",
  "data": {
    "success": true,
    "status": "deleting",
    "post_id": 512
  }
}

Error Responses#

Already live (400)#

{
  "error": "This post has already been published to at least one account",
  "message": "Discarding it would delete the record of a live post. Delete it on the platform instead."
}

Still being created (409)#

The post is still being sent to its platforms. Try again in a minute.

{
  "error": "This post is still being created",
  "message": "Try again in a minute, once it has finished publishing."
}

Discard in progress (409)#

{
  "error": "This post is being discarded",
  "message": "Wait for the discard to finish before changing it."
}

Cancel failed on the platform (502)#

The platform did not confirm the cancel, so the post was not discarded. It is still a draft or still scheduled. Try again.

{
  "error": "Failed to discard post",
  "message": "Could not cancel it on the platform, so it is still scheduled. Try again."
}

Not found (404)#

{
  "error": "Post not found"
}

Unauthorized (403)#

{
  "error": "Access Forbidden"
}

Rate Limits#

• 20 requests per minute per workspace, shared by the publishing and post endpoints. Analytics has its own limit