Account actions

Update an article

Change the title, content or cover of an article. Fields you leave out stay as they are.

Send at least one of title, text, content_state, cover_media_id or remove_cover. text and content_state replace the whole content. Title, content and cover are saved one after the other, like on x.com; when one fails, its answer is returned and the rest is skipped. Billed as one call.

Needs X Premium on the account. Without it X refuses with error code 37 ("Twitter Blue claim is not enabled").

No simple format: with format=simple the answer is the usual {status_code, response} wrapper.

Reference: https://www.twittrapi.com/docs/account-actions/client-articles-update

post/client/articles/update

Request

  • Base URL: https://api.twittrapi.com
  • URL: https://api.twittrapi.com/client/articles/update
  • Auth: API key in header X-API-KEY

Request body

cookiestring required

Cookie header of your own logged-in X session: auth_token=...; ct0=... (guest_id is used when present). How to copy it: /docs/x-session.

proxystring required

Your proxy, format http://user:pass@host:port. The requests to X go out through it. Used only for this request.

article_idstring required

Numeric ID of the article, from /client/articles.

titlestring

Title of the article.

textstring

Content as plain text, one paragraph per line. Send text or content_state, not both.

content_statestring

Content in the format of the x.com editor, {"blocks": [...], "entity_map": [...]}, as /client/articles/get returns it. Use it for headings, links and styles.

cover_media_idstring

Numeric media ID from /client/media or /client/media/video to use as the cover.

cover_media_categorystring

Type of the cover: DraftTweetImage, DraftTweetGif or AmplifyVideo (video).

remove_coverboolean

true removes the cover. Not together with cover_media_id.

Response

Wrapper built by the API: {"status_code": <X status>, "response": "<X response body as a string>"}. The HTTP status is X's status when X answered 4xx or 5xx, otherwise 200. Parse response a second time to get X's JSON.

RawPassthrough required

X's own JSON (raw format, the default), passed through unchanged. The shape is X's and can change; see https://www.twittrapi.com/docs/response-format.

Changes

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