diff --git a/changelog.mdx b/changelog.mdx index c1db3554d..797e81953 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -7,6 +7,28 @@ 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). + + ### Filter qualifiers for X Activity API subscriptions + + X Activity API subscriptions now accept an optional `filter.qualifiers` map of event-specific predicates that narrow which events match. You can scope `chat.received` events by `conversation_type` (`direct` or `group`), and `follow.follow`, `follow.unfollow`, and `like.create` events by `direction` (`inbound` or `outbound`). A subscription can have up to 8 qualifier entries. See [Filter qualifiers](/x-api/activity/introduction#filter-qualifiers) for details. + + ### Broadcast start and end events for X Activity API + + We added two public event types to the [X Activity API](/x-api/activity/introduction): `broadcast.start` and `broadcast.end`. Subscribe by User ID to be notified in real time when a user starts or ends a live broadcast, using either app-only or user-context authentication. Sample payloads are available on the [event payloads](/x-api/activity/event-payloads) page. + + ### New credit balance endpoint + + We added [`GET /2/usage/credits`](/x-api/usage/get-usage-credits), which returns your Pay-Per-Use credit balance in USD so you can monitor remaining credits programmatically. + + ### Pay-per-use monthly Post cap raised to 3 million + + The monthly [Post read cap](/x-api/fundamentals/post-cap) on pay-per-use plans increased from 2 million to 3 million Posts. + + ### `is_subscriber` field on `broadcast.chat` events + + The `broadcast.chat` event payload in the X Activity API now includes an `is_subscriber` boolean alongside the chat message and author details. See the [event payloads](/x-api/activity/event-payloads) page for an updated sample. + + ### Updated `video_total_views` definition