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>",
  },
});

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."
}

Not found (404)#

{
  "error": "Post not found"
}

Unauthorized (403)#

{
  "error": "Access Forbidden"
}

Rate Limits#

• 20 requests per minute per workspace, shared across all social endpoints