Update Twitter Article API

Partial-update an existing Twitter/X article — title, body markdown, or cover image. $0.005 per call. Works on drafts and published articles.

POST/twitter/article/update

This endpoint costs $0.005 per API call. Works on both drafts and published articles.

Partial update — pass only the fields you want to change; the others stay untouched.

Request Body

Field	Type	Required	Description
`auth_token`	string	Yes	User's auth token
`article_id`	string	Yes	The article id returned from `/article/create` or `/article/list`
`title`	string	No	New title
`content`	string	No	New markdown body (replaces the body wholesale)
`cover_media_id`	string	No	Pre-uploaded media id to set as new cover
`cover_image_url`	string	No	URL to upload as the new cover
`cover_image_base64`	string	No	Base64-encoded image data for the new cover
`proxy`	string	No	Your proxy URL

At least one of title, content, or one of the three cover fields must be provided.

Response (200)

{
  "status": "success",
  "msg": "Article updated",
  "data": {
    "article_id": "2055606612363202560",
    "updated": {
      "title": true,
      "content": false,
      "cover_media_id": "2055606606466023424"
    }
  }
}

Error Responses

400 - Missing identifier or update fields

{ "error": "Missing required field: article_id" }

Examples

curl -X POST "https://api.getxapi.com/twitter/article/update" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "your_auth_token",
    "article_id": "2055606612363202560",
    "title": "Renamed Article Title"
  }'

Replace the body and cover

curl -X POST "https://api.getxapi.com/twitter/article/update" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "your_auth_token",
    "article_id": "2055606612363202560",
    "content": "# Rewritten\n\nFresh take.",
    "cover_image_url": "https://picsum.photos/1200/675"
  }'

Update Article