From 1aa6ea8f619fa5d29fda7976e28a07eb534a2a84 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Sun, 30 Aug 2026 02:13:45 +0000
Subject: [PATCH] docs: add changelog entry for X Activity API, usage credits,
 and PPU cap updates

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

diff --git a/changelog.mdx b/changelog.mdx
index c1db3554d..ed2c2f769 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -7,6 +7,28 @@ 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 30, 2026" description="X API">
+  ### Filter qualifiers for X Activity API subscriptions
+
+  We added an optional `filter.qualifiers` map to [X Activity API](/x-api/activity/introduction#filter-qualifiers) subscriptions. Qualifiers narrow which events match, so you only receive the events you care about. You can filter `chat.received` events by `conversation_type` (`direct` or `group`), and `follow.follow`, `follow.unfollow`, and `like.create` events by `direction` (`inbound` or `outbound`). A subscription supports up to 8 qualifiers, and responses echo them back under `filter.qualifiers`.
+
+  ### Broadcast start and end events for 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 can be subscribed to with either app-only or user-context authentication. See [event payloads](/x-api/activity/event-payloads) for sample payloads.
+
+  ### New usage credits endpoint
+
+  We added [`GET /2/usage/credits`](/x-api/usage/get-usage-credits), which returns your Pay-per-use (PPU) credit balance in USD. Use it to monitor your remaining credits programmatically. See the [Usage introduction](/x-api/usage/introduction) for all usage endpoints.
+
+  ### Pay-per-use monthly Post cap raised to 3 million
+
+  We raised the monthly [Post read cap](/x-api/fundamentals/post-cap) on Pay-per-use plans from 2 million to 3 million. If you need higher volume, consider an [Enterprise plan](/forms/enterprise-api-interest).
+
+  ### `is_subscriber` field on `broadcast.chat` events
+
+  The `broadcast.chat` event payload in the X Activity API now includes an `is_subscriber` boolean, indicating whether the chat author is a subscriber of the broadcaster. See [event payloads](/x-api/activity/event-payloads) for an updated sample.
+</Update>
+
 <Update label="Aug 13, 2026" description="X Ads API">
   ### Updated `video_total_views` definition