Delete a post that never went out

Remove a post permanently, along with its delivery records. An agent key may only delete posts an agent created, and only while they are pending_approval, draft, rejected or failed — this is how an assistant clears up drafts the person didn't want instead of leaving them in the approval queue. A scheduled post is taken off the schedule instead of deleted: the answer is 200 with deleted: false, unscheduled: true and the status it went back to (pending_approval, keeping its time for when it is approved again, or draft) — read deleted before reporting what happened. Anything published, or approved by a person, is refused (409) for agents and humans alike: those rows are the receipt of what went out.

delete/posts/{id}

Request

  • Base URL: https://xpost.to/api/v1
  • URL: https://xpost.to/api/v1/posts/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Response

Deleted — or, for a scheduled post, unscheduled; deleted says which

idstring uuid required
deletedboolean required

false means the post still exists and came off the schedule instead

unscheduledboolean

Only on a scheduled post: true, and deleted is false

status'pending_approval' | 'draft'

Where an unscheduled post went back to

messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.