From edfb6b4e1c37f903356b1a9820b951e1f00096f3 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 9 Sep 2026 23:07:21 +0000
Subject: [PATCH] docs: add Sep 9, 2026 changelog entry for this week's API
 updates

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

diff --git a/changelog.mdx b/changelog.mdx
index b965396ee..36fb9213c 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -7,6 +7,30 @@ 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 9, 2026" description="X API v2">
+  ### Block and unblock endpoints for Enterprise
+
+  We added two new endpoints for managing blocks on behalf of an authenticated user:
+
+  - [`POST /2/users/{id}/blocking`](/x-api/users/block-user) — block a user
+  - [`DELETE /2/users/{source_user_id}/blocking/{target_user_id}`](/x-api/users/unblock-user) — unblock a user
+
+  These endpoints are only available on the [Enterprise plan](/enterprise-api/introduction). They are not available on self-serve (pay-per-use) tiers.
+
+  ### Subscription events for X Activity API
+
+  We added subscription events to the [X Activity API](/x-api/activity/introduction). Subscribe by User ID to receive real-time notifications when a user subscribes to another user (`subscriptions.subscribe`) or when a subscription expires (`subscriptions.unsubscribe`). Note that `subscriptions.unsubscribe` is emitted when the subscription actually expires, not upon cancellation.
+
+  Both events support the `direction` qualifier (`inbound`, `outbound`). These are private events: they require user-context (OAuth 2.0) authentication with the `follows.read` scope.
+
+  ### New `broadcast.read` and `broadcast.write` OAuth 2.0 scopes
+
+  We added two new [OAuth 2.0 scopes](/fundamentals/authentication/oauth-2-0/authorization-code) for live broadcasts:
+
+  - `broadcast.read` — view a user's live broadcasts and their chat
+  - `broadcast.write` — manage a user's live broadcasts and send chat messages on their behalf
+</Update>
+
 <Update label="Sep 1, 2026" description="X API v2">
   ### Media upload and Post-create size and duration limits