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
17 changes: 17 additions & 0 deletions changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,23 @@ 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 26, 2026" description="X API v2 & X Ads API">
### This week's roundup

#### New features

- **Bots for the Chat API**: Create and manage programmatic bot accounts with the new `/2/bots` endpoints. Mint, rotate, and revoke a bot's bearer token and manage its identity, all with app-only authentication. See the [Bots guide](/xchat/bots) and [API reference](/x-api/bots/create-a-bot).
- **Broadcast events in the X Activity API**: Subscribe by User ID to `broadcast.start` and `broadcast.end` to receive real-time notifications when a user starts or ends a live broadcast. Both are public events, available with app-only or user-context authentication. Learn more in the [X Activity API docs](/x-api/activity/introduction).
- **X Ads MCP**: Connect Grok, Claude Code, or any MCP-capable client to the official Ads MCP server at `https://ads-api.x.com/mcp` to manage campaigns, pull analytics, and search targeting through 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).
- **Usage credits endpoint**: Check your developer platform credit balance in USD with [`GET /2/usage/credits`](/x-api/usage/get-usage-credits).
- **Delete Chat messages**: Remove one or more messages from a Chat conversation with [`POST /2/chat/conversations/{id}/messages/delete`](/x-api/chat/delete-chat-messages).

#### Updates

- **New Ads API web conversion metrics**: The `WEB_CONVERSION` metrics group in [Analytics](/x-ads-api/analytics) now includes eight additional metrics, such as `conversion_add_to_carts`, `conversion_checkouts_initiated`, `conversion_content_views`, and `conversion_landing_page_views`, segmentable by `PLATFORMS` and `CONVERSION_TAGS`.
- **Community Notes evaluate endpoint moved**: Evaluate a drafted note at [`POST /2/notes/evaluate`](/x-api/community-notes/evaluate-a-community-note). This replaces `POST /2/evaluate_note`.
</Update>

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

Expand Down