Publish a Held Post

Overview#

Publishes a draft or scheduled post immediately, to the accounts it already targets. This is the step that puts the post in front of an audience, and it cannot be undone through Orshot.

To change what goes out, edit the post first.

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

Request#

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

No request body is needed — the post already carries its caption, media and accounts.

Response Fields#

A processing status means every targeted platform publishes asynchronously and the post is still in flight. Sync the post to pick up the final URLs.

A partial status means some accounts succeeded and others did not — check each entry in platforms.

Error Responses#

Post already sent (400)#

{
  "error": "Only draft or scheduled posts can be published"
}

Not found (404)#

{
  "error": "Post not found"
}

Publish failed (500)#

{
  "error": "Failed to publish post",
  "message": "Account token expired — reconnect required"
}

Rate Limits#

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