Skip to content

Draft changelog: Chat bots, XAA qualifiers, broadcast events, credits #368

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Draft changelog: Chat bots, XAA qualifiers, broadcast events, credits #368

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
15 changes: 15 additions & 0 deletions changelog.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,21 @@ 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="Sep 1, 2026" description="X API v2">
### This week: Chat API bots, X Activity API filters and events, usage credits

**New features**

- **Bots for the Chat API**: You can now create and manage programmatic bot accounts for your project with the new `/2/bots` endpoints: create, list, update, and delete bots, plus rotate and revoke bot tokens. Bots authenticate with app-only bearer tokens. See the [Bots guide](/xchat/bots) and [API reference](/x-api/bots/create-a-bot).
- **Filter qualifiers for the X Activity API**: Subscriptions now accept an optional `filter.qualifiers` map (up to 8 entries) to narrow which events match. Use `conversation_type` (`direct`, `group`) on `chat.received`, and `direction` (`inbound`, `outbound`) on `follow.follow`, `follow.unfollow`, and `like.create`. Unsupported keys or values return a 400 error. [Learn more](/x-api/activity/introduction#filter-qualifiers).
- **Broadcast events for the X Activity API**: Subscribe by User ID to the new public `broadcast.start` and `broadcast.end` events to receive real-time notifications when a user starts or ends a live broadcast. Both work with app-only or user-context authentication. See [event payloads](/x-api/activity/event-payloads).
- **Usage credits endpoint**: The new `GET /2/usage/credits` endpoint returns your Pay-Per-Use credit balance in USD. See the [API reference](/x-api/usage/get-usage-credits).

**Updates**

- **`is_subscriber` on `broadcast.chat`**: The `broadcast.chat` event payload now includes an `is_subscriber` boolean alongside the message and author details. See [event payloads](/x-api/activity/event-payloads#broadcast-chat).
</Update>

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

Expand Down