X Docs

X API v2 — Users

New docs for blocking and unblocking users:

• Block User
• Unblock User
• Users ID Block

These cover the /2/users/{source_user_id}/blocking/{target_user_id} endpoint.

X API v2 — Activity

Introduction (/x-api/activity/introduction)

• Documented subscription events: subscriptions.subscribe and subscriptions.unsubscribe (paid profile subscriptions).
• These events support the direction qualifier (inbound / outbound).
• Noted as private events that need user-context auth with the follows.read scope.
• Updated the private-events scope list and the supported-qualifiers table accordingly.

Event payloads (/x-api/activity/event-payloads)

• Added a Subscription events section with example payloads for subscriptions.subscribe and subscriptions.unsubscribe (source / target user shape, similar to follow events).
• Clarified that unsubscribe fires when the subscription expires, not at cancellation time.

Create subscription (/x-api/activity/create-x-activity-subscription)

• Endpoint description now includes follows.read for subscriptions.* events.
• Notes that subscriptions.* requires a user-context token and that filter.user_id must be the authenticated user.
• Qualifiers guidance extended to subscription events.

Fundamentals — Authentication

OAuth 2.0 Authorization Code (/fundamentals/authentication/oauth-2-0/authorization-code)

Scopes table now lists:

• broadcast.read — view live broadcasts and their chat
• broadcast.write — manage live broadcasts and send chat on the user’s behalf