Publish & Cancel Posts

Publish posts immediately or cancel scheduled posts

Publish scheduled posts immediately or cancel them before they go live.

Publish a Post Immediately

You can publish a draft or scheduled post immediately, bypassing the schedule:

POST /v1/workspaces/{id}/posts/{post_id}/publish/

Request

curl -X POST "https://api.missinglettr.com/v1/workspaces/1/posts/123/publish/" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": 123,
  "text": "Hello from the API!",
  "status": "publishing",
  "scheduled_at": null,
  "published_at": "2025-01-15T10:30:00Z"
}

Note: Publishing immediately will start the posting process to all configured platforms. The post status will change to "publishing" and then "published" once complete.

Cancel a Scheduled Post

Cancel a scheduled post before it publishes. This prevents it from going live:

POST /v1/workspaces/{id}/posts/{post_id}/cancel/

Request

curl -X POST "https://api.missinglettr.com/v1/workspaces/1/posts/123/cancel/" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": 123,
  "text": "This was scheduled but now cancelled",
  "status": "cancelled",
  "scheduled_at": null,
  "published_at": null
}

Warning: You cannot cancel a post that has already been published. Only scheduled or draft posts can be cancelled.

Use Cases

  • Urgent Posts: Publish breaking news or time-sensitive content immediately
  • Correction: Cancel a post with an error before it publishes
  • Strategy Change: Cancel campaign posts if plans change
  • Testing: Publish test posts immediately to verify formatting