X
X tools let your AI assistant work with one connected X account: publish and edit posts, reply, publish a long-form Article, search posts, and read a profile by @handle.
You describe what you want in plain language. Publishing, editing, and deleting happen only after you confirm.
The tools
| Tool | Purpose |
|---|---|
| Create post | Publish a post, quote, or poll |
| Edit post | Change a recent post |
| Delete post | Remove a post you own |
| Get post | Read a post by link or id |
| Create reply | Comment on a post |
| List replies | Read replies in a thread |
| Delete reply | Remove a reply you own |
| Publish article | Publish a long-form Article from text you write |
| Search | Find posts by words, tags, and filters |
| Mentions | Posts that mention the connected account |
| Get user | Read a profile by exact @handle |
How they work together
Get user / Search → find a profile or posts
Get post → read one post, including whether it can still be edited
Create post → publish (after you confirm)
Create reply → comment (after you confirm)
List replies → read the thread
Edit / Delete → only your own posts, and only after you confirm
Publish article → long-form post (X Premium, after you confirm)
Limits worth knowing
- A post can be edited for 30 minutes, up to 5 times. The link stays the same for readers, but the tool returns a new id. Replies to other people, polls, ads, and community posts cannot be edited.
- Comments on X are replies. There is no separate comment type.
- Search looks at the last 7 days unless you ask for the full archive. It is a time-ordered match list, not the Top or News tabs in the X app.
- People lookup needs an exact @handle or id. If you only have a name, search posts and use the author on the results.
- Articles cannot be edited through the API after you publish. A correction means publishing again. The account needs X Premium.
Setup for administrators is in the X API developer guide.