From 8320b7364f2752993311388e007a3f3d81e343da Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Sat, 29 Aug 2026 02:13:08 +0000
Subject: [PATCH] docs: add Aug 29 changelog entry for this week's X API
 changes

---
 changelog.mdx | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/changelog.mdx b/changelog.mdx
index c1db3554d..d8de73096 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).
 
+<Update label="Aug 29, 2026" description="X API v2">
+  ### Filter qualifiers for X Activity API subscriptions
+
+  We added an optional `filter.qualifiers` map to [X Activity API](/x-api/activity/introduction) subscriptions. Qualifiers let you narrow which events match, so you only receive the events you need. Two qualifiers are supported today: `conversation_type` (`direct` or `group`) on `chat.received`, and `direction` (`inbound` or `outbound`) on `follow.follow`, `follow.unfollow`, and `like.create`. Each subscription accepts up to 8 qualifiers, and unsupported keys or values return a `400` error. Learn more in [Filter qualifiers](/x-api/activity/introduction#filter-qualifiers).
+
+  ### Broadcast lifecycle events in the X Activity API
+
+  We added two public event types to the X Activity API: `broadcast.start` and `broadcast.end`. Subscribe by User ID to be notified in real time when a user starts or ends a live broadcast. Both events work with app-only or user-context authentication. See sample payloads in [Event payloads](/x-api/activity/event-payloads).
+
+  ### New endpoint to check your Pay-Per-Use credit balance
+
+  We added `GET /2/usage/credits`, which returns your Pay-Per-Use (PPU) credit balance in USD. You can now monitor your remaining credits programmatically. See the [API reference](/x-api/usage/get-usage-credits).
+
+  ### `is_subscriber` field on `broadcast.chat` events
+
+  The `broadcast.chat` event payload now includes an `is_subscriber` boolean alongside the chat message and author details, so you can tell whether a chat message came from a subscriber. See [Event payloads](/x-api/activity/event-payloads).
+</Update>
+
 <Update label="Aug 13, 2026" description="X Ads API">
   ### Updated `video_total_views` definition