Articles

Delete Article

Delete an article you own, identified by its entity id. A Draft is hard-deleted directly. A Published article is unpublished first (reverting it to Draft) and then its announcement tweet is deleted, which is what makes it stop being publicly reachable, a two-step reversal for Publish Article. Pass lifecycle and tweet_id as optional fast-path hints when you already know them (from a prior list/create response); omitted, the server resolves them itself by scanning your Draft then Published lists, costing a couple of extra round trips. Requires a registered session. Billed at $0.0008 per call. Cost: $0.0008 per call.

post/article/delete

Request

  • Base URL: https://api.twitterapis.com/twitter
  • URL: https://api.twitterapis.com/twitter/article/delete
  • Auth: HTTP bearer

Request body

idstring required

The article's base64 entity id, returned by article/create or article/list (the id field, not rest_id).

lifecyclestring

Fast-path hint: "draft" or "published". When you already know the article's lifecycle (e.g. from a prior article/list or article/create response), pass it to skip a lookup. Omit it and the server resolves it by scanning your own Draft then Published lists.

tweet_idstring

Fast-path hint: the announcement tweet id, for a PUBLISHED article only. Omit it and the server resolves it from the article's own metadata when lifecycle resolves to published.

Example request

{
  "id": "QXJ0aWNsZUVudGl0eToyMDg2NjUwMjI4OTUwNjgzNjQ4",
  "lifecycle": "draft",
  "tweet_id": "2086650300012345678"
}

Response

Delete an article. A draft is hard-deleted; a published article is unpublished, then its announcement tweet is removed too.

okboolean

Mirrors deleted.

deletedboolean

True when the delete completed: the draft was hard-deleted, or the published article was unpublished and its announcement tweet removed.

idstring

Echo of the article id you deleted.

Changes

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