From bbb2a159c15f9b2346c60f8e2da23d650ffdc64c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 28 Aug 2026 22:02:19 +0000 Subject: [PATCH] docs: add Aug 28 weekly changelog entry for platform updates --- changelog.mdx | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/changelog.mdx b/changelog.mdx index c1db3554d..11d711c4c 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -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). + + ### 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. + + ### Updated `video_total_views` definition