diff --git a/changelog.mdx b/changelog.mdx index c1db3554d..a1dc426cc 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -7,6 +7,24 @@ 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 for the Chat API, X Ads MCP, and more + + #### New features + + - **Bot accounts for the Chat API**: We added `/2/bots` [endpoints](/x-api/bots/get-bots) for creating and managing programmatic bot accounts owned by your project. You can create a bot, mint and rotate its bearer token, revoke the token, update its handle, display name, and DM permissions, and delete the bot. Bot accounts carry an "Automated by" label. See the [Bots guide](/xchat/bots) to get started. + - **X Ads MCP**: We launched the [X Ads MCP](/x-ads-api/mcp), a remote MCP server at `https://ads-api.x.com/mcp`. Any MCP-capable client (Grok, Claude Code, or your own agent) can read campaign data, run analytics, and create and manage campaigns through natural language. Access is scoped to your OAuth 2.0 token, and new campaigns and line items are always created paused. + - **Broadcast events for the X Activity API**: We added `broadcast.start` and `broadcast.end` events to the [X Activity API](/x-api/activity/introduction). Subscribe by User ID to receive real-time notifications when a user starts or ends a live broadcast. Both are public events and work with app-only or user-context authentication. + - **Subscription filter qualifiers for the X Activity API**: Subscriptions now accept an optional `filter.qualifiers` map (up to 8 entries) to narrow which events match. Supported qualifiers include `conversation_type` (`direct`, `group`) for `chat.received` and `direction` (`inbound`, `outbound`) for `follow.follow`, `follow.unfollow`, and `like.create`. Learn more in the [X Activity API introduction](/x-api/activity/introduction#filter-qualifiers). + - **Usage credits endpoint**: We added [`GET /2/usage/credits`](/x-api/usage/get-usage-credits), which returns your developer-platform credit balance in USD, including prepaid, free, and total balances. + - **Delete Chat messages**: We added [`POST /2/chat/conversations/{id}/messages/delete`](/x-api/chat/delete-chat-messages) to the Chat API. Delete one or more messages from a conversation, either for every participant or only from your own view. + + #### Updates + + - **Pay-per-use monthly Post cap raised to 3 million**: The monthly cap on Post reads for pay-per-use plans increased from 2 million to 3 million. See [Post cap](/x-api/fundamentals/post-cap) for details. + - **`is_subscriber` in `broadcast.chat` payloads**: The `broadcast.chat` event payload in the [X Activity API](/x-api/activity/event-payloads) now includes an `is_subscriber` boolean indicating whether the chat message author is a subscriber of the broadcaster. + + ### Updated `video_total_views` definition