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 28, 2026" description="X API v2">
### Weekly roundup

#### New features

- **Chat API bot endpoints**: You can now create and manage programmatic bot accounts for your project via six new `/2/bots` endpoints: create, list, update, and delete bots, plus rotate and revoke bot tokens. See the [Bots guide](/xchat/bots) and [API reference](/x-api/bots/create-a-bot).
- **Broadcast events for X Activity API**: Subscribe by User ID to two new public events, `broadcast.start` and `broadcast.end`, to be notified in real time when a user starts or ends a live broadcast. See the [event payloads](/x-api/activity/event-payloads).
- **Filter qualifiers for X Activity API subscriptions**: Subscriptions now accept an optional `filter.qualifiers` map (up to 8 entries) to narrow which events match, such as `conversation_type` on `chat.received` and `direction` on `follow.follow`, `follow.unfollow`, and `like.create`. Unsupported keys or values return a 400 error. Learn more in the [introduction](/x-api/activity/introduction#filter-qualifiers).
- **Credit balance endpoint**: `GET /2/usage/credits` returns your Pay-Per-Use credit balance in USD, including total, prepaid, and free balances plus unexpired free grants. See the [API reference](/x-api/usage/get-usage-credits).
- **Delete Chat messages endpoint**: `POST /2/chat/conversations/{id}/messages/delete` deletes one or more messages from a Chat conversation. See the [API reference](/x-api/chat/delete-chat-messages).

#### Updates

- **Pay-Per-Use monthly Post cap raised**: The monthly cap for Pay-Per-Use plans increased from 2 million to 3 million Post reads per billing cycle. See [Post caps](/x-api/fundamentals/post-cap).
- **`is_subscriber` on `broadcast.chat` events**: The `broadcast.chat` event payload now includes an `is_subscriber` boolean indicating whether the message author subscribes to the broadcaster.
</Update>

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

Expand Down