Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,25 @@ keywords: ["changelog", "API updates", "release notes", "what's new", "API chang

To subscribe to updates, please [**“Turn on notifications”**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) for [**@API**](https://x.com/api). You can also follow this changelog in your feed reader via the [**RSS feed**](https://docs.x.com/changelog/rss.xml).

<Update label="Aug 28, 2026" description="X Developer Platform">
### This week: bots, broadcast events, filter qualifiers, and Ads MCP

#### New features

- **Bots for the X Chat API**: You can now create and manage programmatic bot accounts for your project via the new `/2/bots` endpoints. Create, list, update, and delete bots, and rotate or revoke their bearer tokens. Bots are real accounts with their own @handle and carry an "Automated by" label. See the [Bots guide](/xchat/bots).
- **Broadcast events in the X Activity API**: Subscribe to `broadcast.start` and `broadcast.end` to receive real-time notifications when a user starts or ends a live broadcast. The private `broadcast.chat` event delivers chat messages in broadcasts the subscribed user owns and requires the `broadcast.read` scope. See [event payloads](/x-api/activity/event-payloads).
- **Filter qualifiers for X Activity API subscriptions**: Narrow which events match a subscription with the optional `filter.qualifiers` map (up to 8 entries). Use `conversation_type` (`direct` or `group`) on `chat.received`, and `direction` (`inbound` or `outbound`) on follow and like events. [Learn more](/x-api/activity/introduction#filter-qualifiers).
- **X Ads MCP**: A remote MCP server at `https://ads-api.x.com/mcp` gives any MCP-capable client (Grok, Claude Code, or your own agent) 23 tools for reading campaign data, running analytics, and managing campaigns with natural language. Campaigns and line items are always created `PAUSED`, so nothing spends until you activate it. See the [Ads MCP overview](/x-ads-api/mcp).
- **Credit balance endpoint**: `GET /2/usage/credits` returns your Pay-Per-Use credit balance in USD. See the [API reference](/x-api/usage/get-usage-credits).
- **Delete chat messages**: The Chat API now supports deleting messages via `POST /2/chat/conversations/{id}/messages/delete`. See the [API reference](/x-api/chat/delete-chat-messages).

#### Updates

- **Legacy Pro plans are moving to Pay-Per-Use**: After September 1, 2026, legacy Pro subscriptions (monthly and annual) end at the close of the current billing cycle and migrate automatically to PPU. No action is required. Learn more [here](https://devcommunity.x.com/t/important-update-legacy-x-api-pro-plans-are-moving-to-pay-per-use-ppu/273255).
- **Higher pay-per-use post cap**: The monthly Post read cap for pay-per-use plans increased from 2 million to 3 million. See [Usage and billing](/x-api/fundamentals/post-cap).
- **`is_subscriber` on `broadcast.chat`**: The `broadcast.chat` event payload now includes an `is_subscriber` boolean indicating whether the chat author is a subscriber of the broadcaster.
</Update>

<Update label="Aug 13, 2026" description="X Ads API">
### Updated `video_total_views` definition

Expand Down