Posts

Delete post

Removes a post record and cancels queued publishing. Publishing and processing posts are refused. Published posts require delete_mode=posterly for local-only removal, or delete_mode=platform with confirm_published=true for live deletion. Eligible platforms require the original account, a saved post ID and deletion permissions. A failure keeps the record. Legacy confirm_published=true implies platform mode.

delete/api/v1/posts/{id}

Request

  • Base URL: https://www.poster.ly
  • URL: https://www.poster.ly/api/v1/posts/{id}
  • Auth: HTTP bearer

Path parameters

idinteger required

Post ID

Query parameters

delete_mode'posterly' | 'platform'

posterly removes only the record; platform also removes live content. Also accepted in a JSON body.

confirm_publishedboolean

Required for a live platform deletion. Also accepted as a JSON body field. True implies platform mode for legacy clients.

Response

Post deleted successfully

deletedboolean required
idinteger required
delete_mode'posterly' | 'platform'
deleted_idsinteger[]
platform_delete'not_published' | 'not_requested' | 'deleted' | 'no_live_target' required

not_published: no live post. not_requested: explicit local-only removal. deleted: the platform acknowledged deletion. no_live_target: no saved live target; only the posterly record was removed.

Example response

{
  "deleted": true,
  "id": 971,
  "platform_delete": "not_published"
}

Changes

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