[Quick] One-step article publish

Publish a complete X Article in a single call. Suitable for simple, one-shot use cases.

⚠️ Recommended: use the step-by-step flow instead. The step-by-step flow gives you full control — preview the draft before publishing, retry individual steps on failure, and reuse the same article_id across multiple calls.

Step-by-step endpoints:

POST /x/articles/draft → get article_id

PUT /x/articles/{article_id}/cover (optional)

PUT /x/articles/{article_id}/title

PUT /x/articles/{article_id}/content

POST /x/articles/{article_id}/publish → get tweet_id

Returns article_id and tweet_id on success.

Back to API Reference

/Article Endpoints

TwexAPI REST

POST/x/articles/publish

Authorization

AuthorizationBearer token · headerrequired

Global API Bearer Token for TwexAPI. Included as: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Request Body

requiredapplication/json

cookiestringrequired

The user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).

titlestringrequired

Article title

markdownstringrequired

Article body in Markdown format

cover_imagestring | any

Cover image: https URL or local file path (optional)

Show properties

Any of:

string

string

any

any

visibilitystring

Visibility: Public / Followers / Mentioned

default: "Public"

Responses

200Successful Response

codeintegerrequired

200 = success, 429 = rate limit, 500 = server error

msgstringrequired

Human-readable result message

dataArticlePublishData | any

Show properties

Any of:

ArticlePublishData

article_idstringrequired

Article draft ID

tweet_idstringrequired

Tweet ID of the published article post

any

any

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

429Daily tweet limit reached

500Server error

⚡Interactive Console / Try APIPOST/x/articles/publish

Live Console

🌐Target Server:https://api.twexapi.io

● Production Ready

✍️

Write Operation Credentials Guide (TwexAPI Key + Twitter Cookie)

1. TwexAPI Platform Key (Bearer Token): Enter under "API Authorization" below for request billing & authentication.

2. Twitter Account Cookie: For write operations (tweet, like, follow, etc.), provide the target Twitter account's Cookie (e.g. auth_token=...; ct0=...) in the cookie field of Request Body below.

🔑API Authorization

Remember keySync to code samples

TwexAPI Platform Key Bearer TokenRequired

Global API key used across all TwexAPI endpoints. Get it from the console.

📝Request Bodyapplication/json

cookiestringTwitter Account Cookie / Auth Token

RequiredThe user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).

titlestring

RequiredArticle title

markdownstring

RequiredArticle body in Markdown format

cover_imagestring

OptionalCover image: https URL or local file path (optional)

visibilitystring

OptionalVisibility: Public / Followers / Mentioned

💡 Quick send:⌘ / Ctrl+Enter

📡

No Response Yet

Configure parameters in the Request tab and click Send Request below.

Request

curl -X POST "https://api.twexapi.io/x/articles/publish" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "cookie": "string",
  "title": "string",
  "markdown": "string",
  "cover_image": "string",
  "visibility": "Public"
}'

const response = await fetch("https://api.twexapi.io/x/articles/publish", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "cookie": "string",
  "title": "string",
  "markdown": "string",
  "cover_image": "string",
  "visibility": "Public"
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/x/articles/publish",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "cookie": "string",
  "title": "string",
  "markdown": "string",
  "cover_image": "string",
  "visibility": "Public"
},
)

Response

{
  "code": 0,
  "msg": "string",
  "data": {
    "article_id": "string",
    "tweet_id": "string"
  }
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "code": 429,
  "msg": "Daily tweet limit reached, please try again tomorrow."
}

{
  "code": 500,
  "msg": "Internal server error"
}