From 5b9abc504eb33c819690d32903a3dfbfa6cce6d4 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 27 Aug 2026 20:28:41 +0000
Subject: [PATCH] docs: add Aug 27 changelog entry for this week's shipped
 changes

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

diff --git a/changelog.mdx b/changelog.mdx
index c1db3554d..5b66cdb48 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -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="Aug 27, 2026" description="X API v2">
+  ### This week: new usage credits endpoint, X Activity API additions, and a higher PPU post cap
+
+  **New features**
+
+  - **Check your Pay-Per-Use credit balance**: Added [`GET /2/usage/credits`](/x-api/usage/get-usage-credits), a new endpoint that returns your Pay-Per-Use (PPU) credit balance in USD. You can now monitor your remaining credits programmatically instead of checking the developer portal. See the [Usage API docs](/x-api/usage/introduction).
+  - **Broadcast start and end events for X Activity API**: 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, so you can subscribe with either app-only or user-context authentication. Sample payloads are in the [event payloads reference](/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. Use `conversation_type` (`direct` or `group`) on `chat.received`, and `direction` (`inbound` or `outbound`) on `follow.follow`, `follow.unfollow`, and `like.create`. Unsupported keys or values return a 400 error. See [Filter qualifiers](/x-api/activity/introduction#filter-qualifiers).
+
+  **Updates**
+
+  - **Pay-Per-Use monthly post cap raised to 3 million**: The monthly Post read cap on Pay-Per-Use plans increased from 2 million to 3 million. See [Post cap](/x-api/fundamentals/post-cap) and [pricing](/x-api/getting-started/pricing).
+  - **`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 message author is a subscriber of the broadcaster. See the [event payloads reference](/x-api/activity/event-payloads).
+</Update>
+
 <Update label="Aug 13, 2026" description="X Ads API">
   ### Updated `video_total_views` definition