Publish article
Tool ID: x_article_publish
Summary
Turns a title and Markdown into a public X Article. You confirm first. The connected account needs X Premium. There is no way to edit the article afterward through these tools.
When to use it
- You have a longer piece than a normal post.
- You want a cover image on that article.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| X account connected by an administrator | Yes |
| X Premium on that account | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
title |
Yes | Article title. |
markdown |
Yes | The body. Headings, lists, quotes, bold, italic, strikethrough, and links are kept. |
cover_media_id |
No | An image already uploaded to X. |
cover_image_url |
No | An https link to a jpeg, png, gif, or webp (max 5 MB). Do not pass this and a media id together. |
confirm |
Yes to publish | Must be true. |
What you get back
The article id, the public post id, the title, and a status link. Comments on the article are replies on that post; use List replies.
Example prompts
Turn this draft into an X Article titled "What we shipped this week" and ask me to confirm before publishing.
Publish that article with this cover image: https://cdn.example.com/cover.jpg
Tips
- Fix typos before you confirm. The API cannot update a draft or a published article. Publishing again creates a second article.
- Code blocks become plain paragraphs. Pictures inside the Markdown become links, not embedded images.
- To take it down, delete the returned post with Delete post. That is best-effort.