From 9ffb1f74811dc4dc324b4070cb76bdfdfa3bf232 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 10 Sep 2026 23:06:37 +0000
Subject: [PATCH] docs: add Sep 10, 2026 changelog entry

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

diff --git a/changelog.mdx b/changelog.mdx
index b965396ee..120d14065 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 10, 2026" description="X API v2">
+  ### Block and unblock endpoints for Enterprise
+
+  Added two new endpoints for programmatically managing blocks on behalf of a user:
+
+  - [`POST /2/users/{id}/blocking`](/x-api/users/block-user) — block a target user.
+  - [`DELETE /2/users/{source_user_id}/blocking/{target_user_id}`](/x-api/users/unblock-user) — unblock a target user.
+
+  Both endpoints require user-context (OAuth 2.0) authentication and the `block.write` scope, and are available on the Enterprise plan.
+
+  ### Subscription events for X Activity API
+
+  Added `subscriptions.subscribe` and `subscriptions.unsubscribe` events to the [X Activity API](/x-api/activity/introduction). You can now subscribe by User ID to receive real-time notifications when a user subscribes to another user (`subscriptions.subscribe`) or when that subscription expires (`subscriptions.unsubscribe`, emitted on expiration, not on cancellation).
+
+  These are private events: they require user-context (OAuth 2.0) authentication with the `follows.read` scope, and the `user_id` filter matches the user performing the action. See [event payloads](/x-api/activity/event-payloads) for the delivery shape.
+
+  ### New `broadcast` OAuth 2.0 scopes
+
+  Added two new OAuth 2.0 scopes for building against live broadcasts, now listed in the [Authorization Code Flow with PKCE](/fundamentals/authentication/oauth-2-0/authorization-code) scopes table:
+
+  - `broadcast.read` — view your live broadcasts and their chat.
+  - `broadcast.write` — manage your live broadcasts and send chat messages on your behalf.
+</Update>
+
 <Update label="Sep 1, 2026" description="X API v2">
   ### Media upload and Post-create size and duration limits