---
title: "Publish Article"
method: POST
path: "/article/publish"
tags: ["Articles"]
---

# Publish Article

`POST /article/publish`

## Request

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

Publish a draft article as the account behind your registered session, transitioning it from Draft to Published. WARNING: publishing posts a real, public announcement tweet on the account's timeline. This is not a preview or a private action, and it cannot be undone by re-editing the article: once published, the only way back is Delete Article, which unpublishes the article AND removes the announcement tweet. Requires a registered session. Billed at $0.0016 per call. Cost: $0.0016 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).
  - `audience` string: Who can read the published article. Defaults to "Everyone" (X's own dialog default) when omitted.
  - `reply_control` string: Who can reply to the announcement tweet. Defaults to "Everyone" (X's own dialog default) when omitted.
  - `caption` string: Optional caption text for the announcement tweet, up to 256 characters.

## Response `200`

Publish a draft article. This posts a real, public announcement tweet.

- object
  - `ok` boolean: True when the article was published.
  - `article` object: The published article, full shape: id, rest_id, title, preview_text, lifecycle (now Published), content_state, cover_media, media_entities, author, created_at_secs, modified_at_secs, first_published_at_secs (now set), visibility_setting (now Public), tweet_id (the new announcement tweet's id), public_url (https://x.com/i/article/<rest_id>).

## 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)