---
title: "Delete Article"
method: POST
path: "/article/delete"
tags: ["Articles"]
---

# Delete Article

`POST /article/delete`

## Request

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

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.

## Request body

- object
  - `id` string, required: The article's base64 entity id, returned by article/create or article/list (the id field, not rest_id).
  - `lifecycle` string: 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_id` string: 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.

## Response `200`

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

- object
  - `ok` boolean: Mirrors deleted.
  - `deleted` boolean: True when the delete completed: the draft was hard-deleted, or the published article was unpublished and its announcement tweet removed.
  - `id` string: Echo of the article id you deleted.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Insufficient credits
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited
- `5XX`: Server error

---

[API](https://skmtc.dev/twitterapis/apis/twitterapis-api.md) · [All operations](https://skmtc.dev/twitterapis/apis/twitterapis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twitterapis/apis/twitterapis-api/revisions/a33ce0fedb3c?raw)