diff --git a/changelog.mdx b/changelog.mdx index c1db3554d..89c151b34 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -7,6 +7,24 @@ 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). + + ### Broadcast lifecycle 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 be notified in real time when a user starts or ends a live broadcast. Both are public events: you can subscribe with either app-only or user-context authentication. + + ### Filter qualifiers for X Activity API subscriptions + + We added an optional `qualifiers` map to X Activity API subscription filters, so you can narrow which events a subscription delivers. Supported qualifiers include `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) for details. + + ### New endpoint to check your credit balance + + We added [`GET /2/usage/credits`](/x-api/usage/get-usage-credits), which returns your Pay-Per-Use credit balance in USD. Use it to monitor remaining credits programmatically alongside the existing [usage endpoints](/x-api/usage/introduction). + + ### `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 [event payloads](/x-api/activity/event-payloads) for a sample. + + ### Updated `video_total_views` definition