diff --git a/changelog.mdx b/changelog.mdx index c1db3554d..521e5abc3 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -7,6 +7,20 @@ 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). + + ### Broadcasts endpoints for live video + + Today, we added [Broadcasts endpoints](/x-api/broadcasts/list-broadcasts) to the X API v2. You can now manage live video broadcasts programmatically: + + - `GET /2/broadcasts` and `GET /2/broadcasts/{id}` — list your broadcasts and look one up by ID + - `POST /2/broadcasts/scheduled`, `GET /2/broadcasts/scheduled`, and `GET`/`PUT`/`DELETE /2/broadcasts/scheduled/{id}` — create, list, update, and delete scheduled broadcasts + - `POST /2/broadcasts/scheduled/{id}/live` — go live on a scheduled broadcast created with `manual_publish: true` + - `GET`/`POST /2/broadcasts/{id}/chat` — read broadcast chat history and send chat messages to a live broadcast + - `POST /2/broadcasts/{id}/chat/mutes`, `DELETE /2/broadcasts/{id}/chat/mutes/{user_id}`, and `DELETE /2/broadcasts/{id}/chat/{message_id}` — moderate broadcast chat by muting or timing out users and removing messages + + These endpoints require user-context (OAuth 2.0) authentication with the new `broadcast.read` and `broadcast.write` scopes. + + ### Updated `video_total_views` definition diff --git a/docs.json b/docs.json index 31c71b113..2d499fb31 100644 --- a/docs.json +++ b/docs.json @@ -827,6 +827,24 @@ "x-api/news/search-news" ] }, + { + "group": "Broadcasts", + "pages": [ + "x-api/broadcasts/list-broadcasts", + "x-api/broadcasts/get-a-broadcast", + "x-api/broadcasts/list-scheduled-broadcasts", + "x-api/broadcasts/create-a-scheduled-broadcast", + "x-api/broadcasts/get-a-scheduled-broadcast", + "x-api/broadcasts/update-a-scheduled-broadcast", + "x-api/broadcasts/delete-a-scheduled-broadcast", + "x-api/broadcasts/go-live-on-a-scheduled-broadcast", + "x-api/broadcasts/get-broadcast-chat-history", + "x-api/broadcasts/send-a-chat-message-to-a-live-broadcast", + "x-api/broadcasts/mute-or-time-out-a-user-in-a-broadcast-chat", + "x-api/broadcasts/unmute-a-user-in-a-broadcast-chat", + "x-api/broadcasts/remove-a-chat-message-from-a-live-broadcast" + ] + }, { "group": "Media", "pages": [