# Documentation Changelog

Every change made to the Twitch developer documentation

Source: https://dev.twitch.tv/docs/change-log/

## 2026

### 2026-11-10 {#2026-11-10}

New documentation style launched. During migration, some corrections were made:

- [Get Ad Schedule](https://dev.twitch.tv/docs/api/reference/ads.md#get-ad-schedule) and [Snooze Next Ad](https://dev.twitch.tv/docs/api/reference/ads.md#snooze-next-ad) now list their timestamps as Unix timestamps in seconds.
- [Get Content Classification Labels](https://dev.twitch.tv/docs/api/reference/ccls.md#get-content-classification-labels) now lists the correct supported `locale` values.
- [Create Custom Rewards](https://dev.twitch.tv/docs/api/reference/channel-points.md#create-custom-rewards) and [Update Custom Reward](https://dev.twitch.tv/docs/api/reference/channel-points.md#update-custom-reward) no longer list a 200-character limit on `prompt`, and now list the 1,000,000,000 maximum for `cost`.
- [Get Custom Reward Redemption](https://dev.twitch.tv/docs/api/reference/channel-points.md#get-custom-reward-redemption) no longer marks `status` as required, since it's ignored when you specify `id`.
- [Modify Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#modify-channel-information) now says an unsupported `broadcaster_language` fails the request with a 400 instead of being ignored.
- [Get Emote Sets](https://dev.twitch.tv/docs/api/reference/chat.md#get-emote-sets) now lists every `emote_type` value.
- [Get User Emotes](https://dev.twitch.tv/docs/api/reference/chat.md#get-user-emotes) now says follower emotes are included only if you specify `broadcaster_id`; subscribing doesn't add them.
- [Send Chat Message](https://dev.twitch.tv/docs/api/reference/chat.md#send-chat-message) now says `for_source_only` defaults to true with an app access token, and lists every `drop_reason` code.
- [Update Chat Settings](https://dev.twitch.tv/docs/api/reference/chat.md#update-chat-settings) now says `follower_mode` defaults to false.
- [Get Clips](https://dev.twitch.tv/docs/api/reference/clips.md#get-clips) no longer says results for `id` come back in the order of the input IDs.
- [Get Clips](https://dev.twitch.tv/docs/api/reference/clips.md#get-clips) and [Get Stream Markers](https://dev.twitch.tv/docs/api/reference/streams.md#get-stream-markers) no longer list the unsupported `before` parameter
- [Get Stream Markers](https://dev.twitch.tv/docs/api/reference/streams.md#get-stream-markers)' `url` field was corrected to `URL`.
- [Create Conduits](https://dev.twitch.tv/docs/api/reference/conduits.md#create-conduits) and [Update Conduits](https://dev.twitch.tv/docs/api/reference/conduits.md#update-conduits) now list the 1–20,000 range for `shard_count`.
- [Get Conduit Shards](https://dev.twitch.tv/docs/api/reference/conduits.md#get-conduit-shards) now lists every `status` value.
- [Update Conduit Shards](https://dev.twitch.tv/docs/api/reference/conduits.md#update-conduit-shards) now lists transport validation errors as 400 responses instead of per-shard `errors`.
- [Get Drops Entitlements](https://dev.twitch.tv/docs/api/reference/entitlements.md#get-drops-entitlements) now notes that, unless you specify `id` or both a user and a game, only entitlements granted in the last 6 months are returned.
- [Create EventSub Subscription](https://dev.twitch.tv/docs/api/reference/eventsub.md#create-eventsub-subscription) now lists the `is_batching_enabled` field, and its 409 response carries the existing subscription's ID in `message`, not `id`.
- [Get EventSub Subscriptions](https://dev.twitch.tv/docs/api/reference/eventsub.md#get-eventsub-subscriptions) now lists the `conduit` transport, `conduit_id`, `is_batching_enabled`, and three more `status` values, and `condition` was corrected to a JSON object.
- [Create Extension Secret](https://dev.twitch.tv/docs/api/reference/extensions.md#create-extension-secret) and [Get Extension Secrets](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extension-secrets) now note that `content` is base64-encoded.
- [Get Extensions](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extensions) and [Get Released Extensions](https://dev.twitch.tv/docs/api/reference/extensions.md#get-released-extensions)' `state` values were corrected, and both now list `views.live_config`.
- [Get Extension Configuration Segment](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extension-configuration-segment) now notes that `segment` can be specified more than once.
- [Get Extension Live Channels](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extension-live-channels) now says it returns an empty list, not a 404, when no broadcasters that use the extension are live.
- [Send Extension PubSub Message](https://dev.twitch.tv/docs/api/reference/extensions.md#send-extension-pubsub-message) now marks `broadcaster_id` as required only when `is_global_broadcast` is false.
- [Get Games](https://dev.twitch.tv/docs/api/reference/games.md#get-games) no longer marks `id`, `name`, and `igdb_id` as required; you must specify at least one of them.
- [Get Top Games](https://dev.twitch.tv/docs/api/reference/games.md#get-top-games) no longer lists the unsupported `before` parameter.
- [Update Channel Guest Star Settings](https://dev.twitch.tv/docs/api/reference/guest-star.md#update-channel-guest-star-settings) was updated to be PATCH, and its `group_layout` values were corrected.
- [Get Channel Guest Star Settings](https://dev.twitch.tv/docs/api/reference/guest-star.md#get-channel-guest-star-settings) now lists its settings under `data`, and its `group_layout` values were corrected.
- [Create Guest Star Session](https://dev.twitch.tv/docs/api/reference/guest-star.md#create-guest-star-session), [Get Guest Star Session](https://dev.twitch.tv/docs/api/reference/guest-star.md#get-guest-star-session), and [End Guest Star Session](https://dev.twitch.tv/docs/api/reference/guest-star.md#end-guest-star-session) now list guest fields under `guests`, corrected `audio_settings` and `video_settings` to `audio` and `video`, and no longer lists `user_login` or `user_display_name`.
- [Update Guest Star Slot](https://dev.twitch.tv/docs/api/reference/guest-star.md#update-guest-star-slot) now marks `destination_slot_id` as required.
- [Update Guest Star Slot Settings](https://dev.twitch.tv/docs/api/reference/guest-star.md#update-guest-star-slot-settings) no longer lists the unsupported `volume` parameter.
- [Delete Guest Star Slot](https://dev.twitch.tv/docs/api/reference/guest-star.md#delete-guest-star-slot)'s `should_reinvite_guest` was corrected to a Boolean.
- [Get Blocked Terms](https://dev.twitch.tv/docs/api/reference/moderation.md#get-blocked-terms) now lists `cursor` under `pagination`.
- [Get Banned Users](https://dev.twitch.tv/docs/api/reference/moderation.md#get-banned-users) no longer lists the unsupported `before` parameter.
- [Get Moderators](https://dev.twitch.tv/docs/api/reference/moderation.md#get-moderators)' `first` parameter was corrected to an Integer.
- [Get Unban Requests](https://dev.twitch.tv/docs/api/reference/moderation.md#get-unban-requests) now lists `broadcaster_name` at the top level of each request.
- [Create Poll](https://dev.twitch.tv/docs/api/reference/polls.md#create-poll), [End Poll](https://dev.twitch.tv/docs/api/reference/polls.md#end-poll), and [Get Polls](https://dev.twitch.tv/docs/api/reference/polls.md#get-polls) no longer list the `bits_voting_enabled`, `bits_per_vote`, and `bits_votes` fields, and now say `ended_at` is omitted while a poll is active.
- [Get Polls](https://dev.twitch.tv/docs/api/reference/polls.md#get-polls) no longer lists the `MODERATED` status.
- [Create Prediction](https://dev.twitch.tv/docs/api/reference/predictions.md#create-prediction), [End Prediction](https://dev.twitch.tv/docs/api/reference/predictions.md#end-prediction), and [Get Predictions](https://dev.twitch.tv/docs/api/reference/predictions.md#get-predictions) now say `locked_at` is null only if the prediction hasn't been locked.
- [Create Prediction](https://dev.twitch.tv/docs/api/reference/predictions.md#create-prediction)'s `prediction_window` minimum was corrected to 1 second.
- [Create Channel Stream Schedule Segment](https://dev.twitch.tv/docs/api/reference/schedule.md#create-channel-stream-schedule-segment) and [Update Channel Stream Schedule Segment](https://dev.twitch.tv/docs/api/reference/schedule.md#update-channel-stream-schedule-segment)' `duration` was corrected to an Integer.
- [Get Channel Stream Schedule](https://dev.twitch.tv/docs/api/reference/schedule.md#get-channel-stream-schedule) now lists `pagination` at the top level of the response.
- [Search Channels](https://dev.twitch.tv/docs/api/reference/search.md#search-channels) no longer says results are limited to channels that streamed in the past 6 months, and now notes that display names are matched too.
- [Get Followed Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-followed-streams) now notes that it includes only streams from the first 2,000 broadcasters the user followed.
- [Get Stream Markers](https://dev.twitch.tv/docs/api/reference/streams.md#get-stream-markers) now says markers are ordered by their position in the video, not by when they were created.
- [Get Broadcaster Subscriptions](https://dev.twitch.tv/docs/api/reference/subscriptions.md#get-broadcaster-subscriptions) now says `points` and `total` are omitted, not null, when you specify `user_id`.
- [Get User Active Extensions](https://dev.twitch.tv/docs/api/reference/users.md#get-user-active-extensions) now says every slot is always returned, and an inactive slot contains only `active`.
- [Get User Block List](https://dev.twitch.tv/docs/api/reference/users.md#get-user-block-list) has added the `user_id` parameter, which checks whether specific users are blocked.
- [Get Users](https://dev.twitch.tv/docs/api/reference/users.md#get-users) now says `email` is omitted, not empty, for users other than the one in the access token.
- [Update User Extensions](https://dev.twitch.tv/docs/api/reference/users.md#update-user-extensions)' `data` type was corrected to an Object.
- [Delete Videos](https://dev.twitch.tv/docs/api/reference/videos.md#delete-videos) no longer says invalid IDs are ignored; one invalid ID fails the whole request.
- [Get Videos](https://dev.twitch.tv/docs/api/reference/videos.md#get-videos) lists the `past_premiere` and `premiere_upload` types, corrects the `duration` format, and no longer lists a 404 for unknown IDs.
- The `first` parameter was corrected to an Integer in [Get Polls](https://dev.twitch.tv/docs/api/reference/polls.md#get-polls), [Get Predictions](https://dev.twitch.tv/docs/api/reference/predictions.md#get-predictions), [Get Stream Markers](https://dev.twitch.tv/docs/api/reference/streams.md#get-stream-markers), [Get Broadcaster Subscriptions](https://dev.twitch.tv/docs/api/reference/subscriptions.md#get-broadcaster-subscriptions), and [Get Videos](https://dev.twitch.tv/docs/api/reference/videos.md#get-videos).
- Status codes, error reasons, and authorization details were corrected across the API reference.

### 2026-11-04 {#2026-11-04}

The layout of our documentation [changelog](https://dev.twitch.tv/docs/change-log.md) will be updated on or soon after Monday, November 9. Developers who monitor this page should consider using our [RSS feed](https://dev.twitch.tv/docs/rss/change-log.xml) to receive new entries.

### 2026-10-01 {#2026-10-01}

Updated the EventSub type [Channel Chat Notification](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-notification) (channel.chat.notification) to include the `gifted_drops_summary` and `shared_chat_gifted_drops_summary` notice types.

### 2026-09-16 {#2026-09-16}

Added `blocked_link` as a possible value for `reason` in EventSub topics [automod.message.hold v2](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-message-hold-v2) and [automod.message.update v2](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-message-update-v2). When this value is present, the `blocked_term` object will be populated.

### 2026-07-31 {#2026-07-31}

Updated [Extensions CSPs](https://dev.twitch.tv/docs/extensions.md#restrictions-on-content):
- In `connect-src`, updated Google Analytics URLs and included `blob:`
- In `script-src`, updated Google Analytics URLs
- In `img-src`, updated Google Analytics URLs and included Twitch image CDN

### 2026-07-17 {#2026-07-17}

[IRC PRIVMSG Tags](https://dev.twitch.tv/docs/chat/irc.md#privmsg-tags) has been updated to include information about the new `gif` tag, including an example of the tag in use.

### 2026-07-16 {#2026-07-16}

The [channel.chat.message](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-message) EventSub subscription type has been updated to include the new `gif` fragment type. GIF messages now include a `gif` object with `gif_id` and `url` fields alongside the existing `text` on the message fragment.

### 2026-06-26 {#2026-06-26}

V1 of the [stream.offline](https://dev.twitch.tv/docs/eventsub/reference/stream.md#stream-offline) EventSub subscription type has been updated to include the `id` parameter in the event payload.

### 2026-06-25 {#2026-06-25}

[Get Creator Goals](https://dev.twitch.tv/docs/api/reference/goals.md#get-creator-goals) API was updated to include the following goal types:
- `new_bit`
- `new_cheerer`

### 2026-06-18 {#2026-06-18}

The maximum amount of shards that can be updated at a single time using the [Update Conduit Shards](https://dev.twitch.tv/docs/api/reference/conduits.md#update-conduit-shards) API is now publicly stated as 100.

Added `viewermilestone` and `modiversary` message types to IRC's [USERNOTICE Tags](https://dev.twitch.tv/docs/chat/irc.md#usernotice-tags), representing [Watch Streaks](https://help.twitch.tv/s/article/recover-watch-streaks) and [Modiversary](https://help.twitch.tv/s/article/guide-to-custom-messages#ModAnniversary) respectively.

### 2026-06-12 {#2026-06-12}

V1 of the [channel.chat.notification](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-notification) EventSub subscription type has been updated to include `modiversary` and `shared_chat_modiversary`.

The legacy PubSub migration guide has been removed.

### 2026-06-08 {#2026-06-08}

Corrections were made to update the documentation to better clarify current behaviors. None of the below changes represent new or modified functionality, although these may be relevant to projects that did not take these into consideration previously.

Extension SDK:
- Removed unused onPositionChanged from [Extensions SDK referene](https://dev.twitch.tv/docs/extensions/reference.md).

API Reference:
- Updated [Get Channel Teams](https://dev.twitch.tv/docs/api/reference/teams.md#get-channel-teams) and [Get Teams](https://dev.twitch.tv/docs/api/reference/teams.md#get-teams) to match the existing behavior that response body fields `background_image_url` and `banner` may be null in some cases.
- Tags set using [Modify Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#modify-channel-information) are no longer specified as being case-sensitive.

EventSub Reference:
- Included the `unknown` type to the [channel.chat.notification](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-notification) EventSub type

### 2026-05-29 {#2026-05-29}

The app access token support that was added for several endpoints is now considered generally available and is now reflected in the [API reference](https://dev.twitch.tv/docs/api/reference.md).

All Pinned Chat API endpoints are now considered generally available.

### 2026-05-19 {#2026-05-19}

The [Get Custom Power-Up](https://dev.twitch.tv/docs/api/reference/bits.md#get-custom-power-up) API endpoint is now considered generally available.

The [channel.custom_power_up_redemption.add](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-custom-power-up-redemption-add) EventSub subscription type is now available as version 1 to receive a notification when a custom Power-up is redeemed. Version 1 is identical to the beta version - developers using the beta version can update EventSub subscriptions to version 1 without further implementation changes.

### 2026-05-15 {#2026-05-15}

The following API endpoints are now available in open beta for managing mod-pinned messages in a broadcaster's chat room.
* [Get Pinned Chat Message](https://dev.twitch.tv/docs/api/reference/chat.md#get-pinned-chat-message)
* [Pin Chat Message](https://dev.twitch.tv/docs/api/reference/chat.md#pin-chat-message)
* [Update Pinned Chat Message](https://dev.twitch.tv/docs/api/reference/chat.md#update-pinned-chat-message)
* [Unpin Chat Message](https://dev.twitch.tv/docs/api/reference/chat.md#unpin-chat-message)

The [Send Chat Message](https://dev.twitch.tv/docs/api/reference/chat.md#send-chat-message) API endpoint has been updated with a new optional `pin` parameter to support sending and pinning a message in a single request.

### 2026-05-01 {#2026-05-01}

The [Get Custom Power-Up](https://dev.twitch.tv/docs/api/reference/bits.md#get-custom-power-up) API endpoint is now available in open beta to retrieve a full or partial list of a broadcaster's custom Power-ups.

The [channel.custom_power_up_redemption.add](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-custom-power-up-redemption-add) EventSub subscription type is now available in open beta to receive a notification when a custom Power-up is redeemed.

### 2026-04-17 {#2026-04-17}

The [Get EventSub Subscriptions](https://dev.twitch.tv/docs/api/reference/eventsub.md#get-eventsub-subscriptions) API endpoint has been updated to accept a `conduit_id` as an additional filtering option.

The [Create EventSub Subscription](https://dev.twitch.tv/docs/api/reference/eventsub.md#create-eventsub-subscription) API endpoint has been updated to provide the `id` of the existing EventSub subscription when a 409 Conflict is returned.

### 2026-04-02 {#2026-04-02}

V1 of the [channel.chat.notifications](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-notification) EventSub subscription type has been updated to include Watch Streaks.

V1 of the [channel.bits.use](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-bits-use) EventSub subscription type have received the following updates.
* Custom Power-ups have been added as an event type
* [Combos](https://help.twitch.tv/s/article/combos) has been removed from event types

V1 of the [channel.chat.notification](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-notification) EventSub subscription type has been updated to include `is_source_only` for chat announcements during a shared chat session.

The [Send Chat Announcement](https://dev.twitch.tv/docs/api/reference/chat.md#send-chat-announcement) API endpoint has received the following updates.
* Added support for app access token authorization
* Added the `for_source_only` optional parameter to specify during a shared chat session if the announcement should be sent only to the source channel or both channels

### 2026-03-25 {#2026-03-25}

Introduced [RSS feed](https://dev.twitch.tv/docs/rss/change-log.xml) for the documentation's [changelog](https://dev.twitch.tv/docs/change-log.md).

### 2026-02-27 {#2026-02-27}

App access token support has been added for several endpoints in open beta and is now reflected in the [API reference](https://dev.twitch.tv/docs/api/reference.md).

### 2026-02-05 {#2026-02-05}

The following API endpoints are now considered generally available:
* [Create Clip From VOD](https://dev.twitch.tv/docs/api/reference/clips.md#create-clip-from-vod)
* [Add Suspicious Status to Chat User](https://dev.twitch.tv/docs/api/reference/moderation.md#add-suspicious-status-to-chat-user)
* [Remove Suspicious Status From Chat User](https://dev.twitch.tv/docs/api/reference/moderation.md#remove-suspicious-status-from-chat-user)

The "Get Hype Train Events" API endpoint has been removed in favor of [Get Hype Train Status](https://dev.twitch.tv/docs/api/reference/hype-train.md#get-hype-train-status). See more information in the related [announcement](https://discuss.dev.twitch.com/t/legacy-get-hype-train-events-api-and-eventsub-hype-train-v1-subscription-types-deprecation-and-withdrawal-timeline/64299/).

### 2026-01-16 {#2026-01-16}

Added the following Twitch API endpoints for open beta:

- [Add suspicious status to chat user](https://dev.twitch.tv/docs/api/reference/moderation.md#add-suspicious-status-to-chat-user) - Adds a suspicious user status to a chatter on the broadcaster's channel.
- [Remove suspicious status from chat user](https://dev.twitch.tv/docs/api/reference/moderation.md#remove-suspicious-status-from-chat-user) - Remove a suspicious user status from a chatter on broadcaster's channel.

### 2026-01-08 {#2026-01-08}

Released translated versions of the [Twitch Drops guides](https://dev.twitch.tv/docs/drops.md) for the following languages:
 * [日本語](https://dev.twitch.tv/docs/ja/drops.md)
 * [中文 简体](https://dev.twitch.tv/docs/zh/drops.md)
 * [한국어](https://dev.twitch.tv/docs/ko/drops.md)
 * [العربية](https://dev.twitch.tv/docs/ar/drops.md)

## 2025

### 2025-12-19 {#2025-12-19}

* [Create Clip From VOD](https://dev.twitch.tv/docs/api/reference/clips.md#create-clip-from-vod) is now available in open beta.
* [Create Clip](https://dev.twitch.tv/docs/api/reference/clips.md#create-clip) has been updated to include the following improvements:
  * 2k video (if applicable)
  * Vertical video from dual format streams (if applicable)
  * An optional parameter for **title**
  * An optional parameter for **duration**
  * An updated edit URL with more features

For more details, see [our announcement](https://discuss.dev.twitch.com/t/introducing-clip-api-improvements-and-clip-from-vod-in-open-beta/64492/).

### 2025-12-16 {#2025-12-16}

Added a C# code sample to demonstrate [Drops offline inventory](https://dev.twitch.tv/docs/drops/technical-guide.md#twitch-api-offline-inventory).

### 2025-10-30 {#2025-10-30}

[Get Clips Download](https://dev.twitch.tv/docs/api/reference/clips.md#get-clips-download) and [Get Authorization By User](https://dev.twitch.tv/docs/api/reference/users.md#get-authorization-by-user) are now considered generally available.

### 2025-10-18 {#2025-10-18}

Added a new Twitch API endpoint for open beta:

* [Get Authorization By User](https://dev.twitch.tv/docs/api/reference/users.md#get-authorization-by-user) - Gets the authorization scopes that the specified user(s) have granted the application.

### 2025-10-14 {#2025-10-14}

Updated the Drops Campaign Guide's Consideration section to include [Overlapping Campaign Behavioral Considerations](https://dev.twitch.tv/docs/drops/campaign-guide.md#overlapping-campaign-behavioral-considerations), detailing new behavioral changes to how incremental Minutes Watched and Subscriptions are distributed across Drops campaigns simultaneously running on a channel.

### 2025-10-06 {#2025-10-06}

[Monetization Strategies](https://dev.twitch.tv/docs/extensions/monetization-strategies.md) has been added to provide implementation suggestions for the Bits-in-Extensions.

### 2025-09-19 {#2025-09-19}

Added a new Twitch API endpoint for open beta:
- [Get Clips Download](https://dev.twitch.tv/docs/api/reference/clips.md#get-clips-download) - Provides URLs to download the video file(s) for the specified clips.

### 2025-08-28 {#2025-08-28}

Added [Chatbot Badge and Chat Identity](https://dev.twitch.tv/docs/chat.md#chatbot-badge-and-chat-identity) section to _Chat & Chatbots_. This section provides details and requirements for a chatbot to appear with the Chat Bot Badge when chat sending messages, and appear as a Chat Bot under Users in Chat when reading chat messages.

### 2025-08-22 {#2025-08-22}

[IRC Concepts](https://dev.twitch.tv/docs/chat/irc.md) updated to reflect the [decommission](https://discuss.dev.twitch.com/t/decommission-of-non-secure-websocket-connections-to-twitch-irc-servers/64142) on August 15, 2025.

### 2025-08-19 {#2025-08-19}

[Get Hype Train Status](https://dev.twitch.tv/docs/api/reference/hype-train.md#get-hype-train-status) is now generally available.

### 2025-08-14 {#2025-08-14}

[Embed guides](https://dev.twitch.tv/docs/embed.md) have been updated to standardize minimum size requirements and note the requirements for autoplay functionality.

### 2025-07-31 {#2025-07-31}

Added a new Twitch API endpoint for open beta:
- [Get Hype Train Status](https://dev.twitch.tv/docs/api/reference/hype-train.md#get-hype-train-status) - Get the status of a Hype Train for the specified broadcaster.

### 2025-06-13 {#2025-06-13}

V1 of the following EventSub subscriptions have been deprecated and  V2 versions are now available for migration:
   * Channel Hype Train Begin -  A Hype Train begins on the specified channel.
      * [channel.hype_train.begin V1](https://dev.twitch.tv/docs/eventsub/reference/hype-train.md#channel-hype-train-begin) 
      * [channel.hype_train.begin V2](https://dev.twitch.tv/docs/eventsub/reference/hype-train.md#channel-hype-train-begin) 
   * Channel Hype Train Progress - A Hype Train makes progress on the specified channel.
      * [channel.hype_train.progress V1](https://dev.twitch.tv/docs/eventsub/reference/hype-train.md#channel-hype-train-progress)
      * [channel.hype_train.progress V2](https://dev.twitch.tv/docs/eventsub/reference/hype-train.md#channel-hype-train-progress)
   * Channel Hype Train End - A Hype Train ends on the specified channel.
      * [channel.hype_train.end V1](https://dev.twitch.tv/docs/eventsub/reference/hype-train.md#channel-hype-train-end)
      * [channel.hype_train.end V2](https://dev.twitch.tv/docs/eventsub/reference/hype-train.md#channel-hype-train-end)

### 2025-05-23 {#2025-05-23}

The [Twitch Drops Guide](https://dev.twitch.tv/docs/drops.md) has been updated to include additional high-level information about Drops, expanded FAQs, and a separate [Campaign Guide](https://dev.twitch.tv/docs/drops/campaign-guide.md) and [Technical Guide](https://dev.twitch.tv/docs/drops/technical-guide.md).

### 2025-05-09 {#2025-05-09}

This release includes the following updates:

* [Get EventSub Subscriptions](https://dev.twitch.tv/docs/api/reference/eventsub.md#get-eventsub-subscriptions) has been updated to include the new `subscription_id` parameter that returns an array with the subscription matching the ID (as long as it is owned by the client making the request), or an empty array if there is no matching subscription.
* [Channel Bits Use](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-bits-use) has been updated to send when a user Combos in a channel.

### 2025-04-17 {#2025-04-17}

Updated description of [Send Chat Message API](https://dev.twitch.tv/docs/api/reference/chat.md#send-chat-message) and its `for_source_only` parameter to clarify how chat messages are sent depending on token type.

### 2025-04-15 {#2025-04-15}

Following deprecation of PubSub, PubSub Guide has been replaced with [Legacy PubSub to EventSub Migration Guide](https://dev.twitch.tv/docs/pubsub).

### 2025-04-10 {#2025-04-10}

This release includes the following updates:

The new `is_source_only` field and `for_source_only` parameter have been added to [Channel Chat Message](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-message) and [Send Chat Message](https://dev.twitch.tv/docs/api/reference/chat.md#send-chat-message) to indicate, when in a shared chat session, if a chat message is sent only to the source channel or both channels.

Updates and additions are now reflected in the following:

1. Updated EventSub subscription:
   * Channel Chat Message
     * [channel.chat.messsage](https://dev.twitch.tv/docs/eventsub/eventsub-subscription-types/#shared-chat-message-example) - Any user sends a message to a specific chat room. 
2. Updated API:
   * Send Chat Message
     * [Send Chat Message](https://dev.twitch.tv/docs/api/reference/chat.md#send-chat-message) - Sends a message to the broadcaster’s chat room.
3. Added IRC PRIVMSG tag:
   * `source-only`
     * [source-only](https://dev.twitch.tv/docs/chat/irc.md#privmsg-tags) - A Boolean that indicates if a message sent during a shared chat session is only sent to the source channel. Has no effect if the message is not sent during a shared chat session.

### 2025-03-18 {#2025-03-18}

This release includes the following updates:
1. EventSub:
    * [Channel Suspicious User Message Event](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-suspicious-user-message) - Updated the **types** field to reflect the following return values:
        - ban_evader
        - manually_added
        - banned_in_shared_channel
    * [Get EventSub Subscriptions](https://dev.twitch.tv/docs/eventsub/manage-subscriptions.md#getting-the-list-of-events-you-subscribe-to) - Updated the following note to accurately reflect the functionality when a WebSocket is disconnected: 
        - The GET API returns disabled WebSocket subscriptions for a minimum of 1 minute as compared to webhooks which returns disabled subscriptions for a minimum of 10 days.
2. Twitch API:
    * [Update User API Endpoint](https://dev.twitch.tv/docs/api/reference/users.md#update-user)- Added a new error code:
        - 429 Too many requests: The app exceeded the number of requests that it may make.

### 2025-02-27 {#2025-02-27}

This release includes updates to the following EventSub subscription types:

1. [Channel Bits Use](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-bits-use) - Updated from open beta to V1.
2. [Channel Points Automatic Reward Redemption Add V2](https://dev.twitch.tv/docs/eventsub/reference/channel-points.md#channel-channel-points-automatic-reward-redemption-add-v2) - Updated from open beta to V2.

### 2025-02-19 {#2025-02-19}

This release includes the following updates for Twitch API endpoints and EventSub subscription types:

1. [Channel Bits Use](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-bits-use) - Added the following parameters:
   - `emote_set_id`
   - `owner_id`
   - `format`
2. [Get Extension Live Channels](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extension-live-channels) - updated the following parameter to better reflect its actual functionality.
   - `first` - The specific maximum number of items per page in the response. The actual number returned may be less than this limit. [Read More](https://dev.twitch.tv/docs/api/guide.md#pagination)

### 2025-02-12 {#2025-02-12}

The following V2 EventSub subscription type is now available in open beta:
   * [channel.channel_points_automatic_reward_redemption.add](https://dev.twitch.tv/docs/eventsub/reference/channel-points.md#channel-channel-points-automatic-reward-redemption-add-v2) -  A viewer has redeemed an automatic channel points reward on the specified channel.

### 2025-02-06 {#2025-02-06}

The following EventSub subscription type is now available in open beta:

* [Channel Bits Use](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-bits-use) - A notification is sent whenever Bits are used on a channel.

### 2025-01-30 {#2025-01-30}

Added [Legacy PubSub to EventSub Migration Guide](https://dev.twitch.tv/docs/pubsub/migration/).

### 2025-01-21 {#2025-01-21}

[Send Chat Announcement](https://dev.twitch.tv/docs/api/reference/chat.md#send-chat-announcement) now includes response code 429 (Too Many Requests) in its Response Codes section.

### 2025-01-13 {#2025-01-13}

[Get Clips](https://dev.twitch.tv/docs/api/reference/clips.md#get-clips) has been updated to reflect the maximum number of results to be returned over multiple paginated requests.

## 2024

### 2024-12-05 {#2024-12-05}

This release includes the following updates:

The following V2 Automod Message EventSub subscription types are now available in v2:
   * [automod.message.hold](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-message-hold-v2) -  A user is notified if a message is caught by automod for review. Only public blocked terms trigger notifications, not private ones.
   * [automod.mesage.update](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-message-update-v2) - A message in the automod queue had its status changed. Only public blocked terms trigger notifications, not private ones.

### 2024-12-04 {#2024-12-04}

The [Twitch Drops Guide](https://dev.twitch.tv/docs/drops.md) has been updated to include information regarding subscription-based Drops, now available for all game developers.

We have also revised the [Developer Services Agreement](https://www.twitch.tv/p/en/legal/developer-agreement/) to include subscription-based Twitch Drops, and reorganized related Drops information. Game developers who currently or plan to use Twitch Drops should take a moment to review the revised Agreement.

### 2024-11-25 {#2024-11-25}

This release includes the following updates:

1. Added information about the Game Maker version of the Twitch Game Engine Plugins

### 2024-11-21 {#2024-11-21}

This release includes the following updates:

Hype Train EventSub subscription types now indicate whether a Hype Train is a Golden Kappa Train:
   * [channel.hype_train.begin](https://dev.twitch.tv/docs/eventsub/reference/hype-train.md#channel-hype-train-begin) -  A Hype Train begins on the specified channel.
   * [channel.hype_train.progress](https://dev.twitch.tv/docs/eventsub/reference/hype-train.md#channel-hype-train-progress) - A Hype Train makes progress on the specified channel.
   * [channel.hype_train.end](https://dev.twitch.tv/docs/eventsub/reference/hype-train.md#channel-hype-train-end) - A Hype Train ends on the specified channel.

### 2024-11-12 {#2024-11-12}

This release includes the following updates:

The following V2 Automod Message EventSub subscription types are now available in open beta:
   * [automod.message.hold](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-message-hold-v2) -  A user is notified if a message is caught by automod for review.
   * [automod.mesage.update](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-message-update-v2) - A message in the automod queue had its status changed.

### 2024-11-01 {#2024-11-01}

[Get Content Classification Labels](https://dev.twitch.tv/docs/api/reference/ccls.md#get-content-classification-labels) and [Modify Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#modify-channel-information) have been updated to support the new Content Classification Label, "Politics and Sensitive Social Issues."

### 2024-09-16 {#2024-09-16}

This release includes the following updates:

1.  The following EventSub subscription types were updated from open beta to V1:
   * Shared Chat
         * [channel.shared_chat.begin](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-shared-chat-begin) - A notification when a channel becomes active in an active shared chat session.
         * [channel.shared_chat.update](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-shared-chat-update) - A notification when the active shared chat session the channel is in changes.
         * [channel.shared_chat.end](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-shared-chat-end) - A notification when a channel leaves a shared chat session or the session ends.
2. The following API was updated from open beta to V1:
   * Get Shared Chat Session
     * [Get Shared Chat Session](https://dev.twitch.tv/docs/api/reference/chat.md#get-shared-chat-session) - Retrieves the active shared chat session for a channel.

### 2024-09-10 {#2024-09-10}

This release includes the following updates:

1. Updated IRC PRIVMSG tags to include the following new tags:
   - `source-room-id`
   - `source-id`
   - `source-badges`
   - `source-badge-info`
2. Updated IRC USERNOTICE tags to include the following changes:
   - Introduced new tag `source-room-id`
   - Introduced new tag `source-id`
   - Introduced new tag `source-msg-id`
   - Introduced new tag `source-badges`
   - Introduced new tag `source-badge-info`
   - Added possible value of `sharedchatnotice` to the existing `msg-id` tag
3. Added [Shared Chat](https://dev.twitch.tv/docs/chat/irc.md#shared-chat) section to IRC Concepts, detailing the handling of Shared Chat on IRC

### 2024-09-06 {#2024-09-06}

This release includes the following updates:

1.  The following EventSub subscription types are now available in open beta:
   * Shared Chat
         * [channel.shared_chat.begin](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-shared-chat-begin) - A notification when a channel becomes active in an active shared chat session.
         * [channel.shared_chat.update](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-shared-chat-update) - A notification when the active shared chat session the channel is in changes.
         * [channel.shared_chat.end](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-shared-chat-end) - A notification when a channel leaves a shared chat session or the session ends.
2. The following item was added to the API reference in open beta:
   * Get Shared Chat Session
     * [Get Shared Chat Session](https://dev.twitch.tv/docs/api/reference/chat.md#get-shared-chat-session) - Retrieves the active shared chat session for a channel.
3.  The following EventSub subscription types have been updated:
* Chat Message
  - [channel.chat.message V1](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-message)
* Chat Notification
  - [channel.chat.notification](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-notification)
* Chat Moderate V1 and V2
  - [channel.moderate V1](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-moderate)
  - [channel.moderate V2](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-moderate-v2)

### 2024-08-01 {#2024-08-01}

This release includes the following updates:

1. The [Chat & Chatbots](https://dev.twitch.tv/docs/chat.md) section has been reworked to describe information about Chat using EventSub and IRC.
   * IRC reference pages were merged into the [IRC Concepts](https://dev.twitch.tv/docs/chat/irc.md) page.
   * The page **Moderating a Broadcaster's chat** under [Twitch API](https://dev.twitch.tv/docs/api.md) was moved to Chat & Chatbots as [Moderation](https://dev.twitch.tv/docs/chat/moderation.md). The old page URL will redirect to the new location.
1. The [Scopes](https://dev.twitch.tv/docs/authentication/scopes.md) page was updated to contain clearer and additional information:
   * Scopes are split by **API/EventSub**, **IRC**, and **PubSub**.
   * Links to EventSub reference were added to relevant scopes

### 2024-07-11 {#2024-07-11}

This release includes the following updates:

1. The following EventSub subscription types were updated from open beta to V1:
   * Channel Warnings
     * [channel.warning.acknowledge](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-warning-acknowledge) - A user acknowledges a warning.
     * [channel.warning.send](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-warning-send) - A user is sent a warning.
2. The following EventSub subscription type was updated from open beta to V2:
   * Moderator Actions
     * [channel.moderate v2](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-moderate-v2) - A moderator performs a moderation action in a channel. Includes warnings.
3. The following API endpoint was updated from open beta to V1:
   * Warn Chat User
     * [Warn Chat User API Endpoint](https://dev.twitch.tv/docs/api/reference/moderation.md#warn-chat-user) - Warns a user in the specified broadcaster’s chat room, preventing them from interaction with the chat until the warning is acknowledged.
4. The following scopes were added to the [Twitch API scopes](https://dev.twitch.tv/docs/authentication/scopes.md#twitch-api-scopes):
   * `moderator:manage:warnings` - Warn users in channels where you have the moderator role.
   * `moderator:read:warnings` - Read warnings in channels where you have the moderator role.

### 2024-07-09 {#2024-07-09}

This release includes the following updates:

1. There is no longer a requirement to have an Apple Developer account, or fill out the iOS Allowlist form, to allow an Extension to work on the iOS version of the Twitch app. All mobile Extensions, existing and new, are available on iOS and Android without additional requirements in the submission process.
   * [Developer Forums announcement](https://discuss.dev.twitch.com/t/policy-updates-regarding-mobile-enabled-extensions-on-ios/59518/)
   * Updated messaging in [Building Extensions](https://dev.twitch.tv/docs/extensions/building.md#mobile-support).
1. Added policy 3.5 to [Extensions Guidelines & Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md#3-mobile).

### 2024-06-19 {#2024-06-19}

This release includes the following updates:

1. The following EventSub subscription types are now available in open beta:
   * Moderator Actions
     * [channel.moderate v2](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-moderate-v2) - A moderator performs a moderation action in a channel. Includes warnings. This event's version will eventually migrate version from `beta` to `2` in a future release.
   * Channel Warnings
     * [channel.warning.acknowledge](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-warning-acknowledge) - A user acknowledges a warning.
     * [channel.warning.send](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-warning-send) - A user is sent a warning.
2. The following item was added to the API reference in open beta:
   * Warn Chat User
     * [Warn Chat User API Endpoint](https://dev.twitch.tv/docs/api/reference/moderation.md#warn-chat-user) - Warns a user in the specified broadcaster’s chat room, preventing them from interaction with the chat until the warning is acknowledged.

### 2024-06-13 {#2024-06-13}

This release includes the following updates:

1. [Channel Chat Message](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-message):
   * The following enum values for the `message_type` field have been changed:
     * `animated` has been renamed to `power_ups_message_effect`
     * `gigantified_emote` has been renamed to `power_ups_gigantified_emote` 
2. [Automatic Point Redemption Add](https://dev.twitch.tv/docs/eventsub/eventsub-reference/#channel-points-automatic-reward-redemption-add-event):
   * The following enum values for the `reward_type` field have been changed:
     * `send_animated_message` has been renamed to `message_effect`
     * `send_gigantified_emote` has been renamed to `gigantify_an_emote`

### 2024-06-11 {#2024-06-11}

This release includes the following updates:

1. General improvements made to [Unity Guide](https://dev.twitch.tv/docs/game-engine-plugins/unity-guide.md)
  * Fixed Typos
  * General code improvements
  * General rewording to improve readability
  * Updated unitypackage to include experiemental Mac support

### 2024-05-22 {#2024-05-22}

This release includes the following updates:

1. [Channel Chat Message](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-message) now supports:
   * A new field:
     * `channel_points_animation_id`
   * The following new enum values for the `message_type` field:
     * animated
     * gigantified\_emote
2. [Automatic Point Redemption Add](https://dev.twitch.tv/docs/eventsub/eventsub-reference/#channel-points-automatic-reward-redemption-add-event) now supports:
   * The following new enum values for the `reward_type` field:
     * send\_animated\_message
     * send\_gigantified\_emote
     * celebration

### 2024-04-22 {#2024-04-22}

This release includes the following updates:

1. All [Goal Subscription](https://dev.twitch.tv/docs/eventsub/eventsub-subscription-types/#goal-subscriptions) EventSub events were updated to include two new goal `type` values:
   * new_bit
   * new_cheerer

### 2024-04-12 {#2024-04-12}

This release includes the following updates:

1. The following items were updated from open beta to V1:
   * Low Trust User (Suspicious User)
     * [channel.suspicious_user.message](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-suspicious-user-message) - A chat message has been sent by a suspicious user.
     * [channel.suspicious_user.update](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-suspicious-user-update) - A suspicious user has been updated.
1. Made updates to [Get User Emotes](https://dev.twitch.tv/docs/api/reference/chat.md#get-user-emotes) API endpoint:
   * Re-added `broadcaster_id` query parameter. The description of this query parameter was updated to reflect it's purpose.

### 2024-04-05 {#2024-04-05}

This release includes the following updates:

1. The following events are now available in open beta:
   * Low Trust User (Suspicious User)
     * [channel.suspicious_user.message](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-suspicious-user-message) - A chat message has been sent by a suspicious user.
     * [channel.suspicious_user.update](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-suspicious-user-update) - A suspicious user has been updated.
2. The following items were updated from open beta to V1:
   * Moderator Actions
     * [channel.moderate](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-moderate) - A moderator performs a moderation action in a channel.
   * VIP Add and Remove
     * [channel.vip.add](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-vip-add) - A VIP is added to the channel.
     * [channel.vip.remove](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-vip-remove) - A VIP is removed from the channel.
   * Whisper Received
     * [user.whisper.message](https://dev.twitch.tv/docs/eventsub/reference/user.md#user-whisper-message) - A user receives a whisper.
   * Channel Point Redemptions
     * [channel.channel\_points\_automatic\_reward\_redemption.add](https://dev.twitch.tv/docs/eventsub/reference/channel-points.md#channel-channel-points-automatic-reward-redemption-add) - A viewer has redeemed an automatic channel points reward on the specified channel.
3. Expanded supported EventSub status messages on the following API endpoints:
   * [Get EventSub Subscriptions](https://dev.twitch.tv/docs/api/reference/eventsub.md#get-eventsub-subscriptions)
   * [Get Conduit Shards](https://dev.twitch.tv/docs/api/reference/conduits.md#get-conduit-shards)
   * [Update Conduit Shards](https://dev.twitch.tv/docs/api/reference/conduits.md#update-conduit-shards)
4. Made updates to [Get User Emotes](https://dev.twitch.tv/docs/api/reference/chat.md#get-user-emotes) API endpoint:
   * Expanded possible values for `emote_type` field in response.
   * Removed `broadcaster_id` query parameter.

### 2024-03-15 {#2024-03-15}

This release includes the following updates:

1. The following EventSub subscription types are now available in open beta:
   * Moderator Actions
     * [channel.moderate](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-moderate) - A moderator performs a moderation action in a channel.
   * VIP Add and Remove
     * [channel.vip.add](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-vip-add) - A VIP is added to the channel.
     * [channel.vip.remove](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-vip-remove) - A VIP is removed from the channel.
   * Whisper Received
     * [user.whisper.message](https://dev.twitch.tv/docs/eventsub/reference/user.md#user-whisper-message) - A user receives a whisper.
   * Channel Point Redemptions
     * [channel.channel\_points\_automatic\_reward.add](https://dev.twitch.tv/docs/eventsub/eventsub-subscription-types/#channelchannel_points_automatic_rewardadd) - A viewer has redeemed an automatic channel points reward on the specified channel.
2. The following items were updated from open beta to V1:
   * Twitch API
     * [Get User Emotes API Endpoint](https://dev.twitch.tv/docs/api/reference/chat.md#get-user-emotes) - Retrieves emotes available to the user across all channels.
   * EventSub Type Subscriptions
     * Unban Requests
       * [channel.unban\_request.create](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-unban-request-create) - Sends a notification when a user creates an unban request.
       * [channel.unban\_request.resolve](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-unban-request-resolve) - Sends a notification when an unban request has been resolved.
     * Automod
       * [automod.message.hold](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-message-hold-v2) - Notifies a user when a message is caught by automod for review.
       * [automod.message.update](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-message-update) - Sends a notification when a message in the automod queue had its status changed.
       * [automod.settings.update](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-settings-update) - Sends a notification when a broadcaster’s automod settings are updated.
       * [automod.terms.update](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-terms-update) - Sends a notification when a broadcaster’s automod terms are updated. Changes to private terms are not sent.
       * [channel.chat.user\_message\_hold](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-user-message-hold) - Notifies a user if their message is caught by automod.
       * [channel.chat.user\_message\_update](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-user-message-update) - Notifies a user if their message’s automod status is updated.

### 2024-03-07 {#2024-03-07}

This release includes the following updates:

1. [Channel Chat Settings Update](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-settings-update) has moved from public beta to v1.
2. Added the following Twitch API endpoints and EventSub subscription types in open beta:
   * Twitch API:
     * [Get Unban Requests](https://dev.twitch.tv/docs/api/reference/moderation.md#get-unban-requests) - Gets a list of unban requests for a broadcaster's channel.
     * [Resolve Unban Requests](https://dev.twitch.tv/docs/api/reference/moderation.md#resolve-unban-requests) - Resolve an unban request by approving or denying it.
     * [Get User Emotes](https://dev.twitch.tv/docs/api/reference/chat.md#get-user-emotes) - Retrieves emotes available to the user.
   * EventSub subscription types:
     * Unban Requests
       * [channel.unban\_request.create](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-unban-request-create) - Sends a notification when a user creates an unban request.
       * [channel.unban\_request.resolve](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-unban-request-resolve) -  Sends a notification when an unban request has been resolved.
     * Automod
       * [automod.message.hold](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-message-hold-v2) - Notifies a user when a message is caught by automod for review.
       * [automod.message.update](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-message-update) - Sends a notification when a message in the automod queue had its status changed.
       * [automod.settings.update](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-settings-update) - Sends a notification when a broadcaster’s automod settings are updated.
       * [automod.terms.update](https://dev.twitch.tv/docs/eventsub/reference/automod.md#automod-terms-update) - A notification is sent when a broadcaster’s automod terms are updated. Changes to private terms are not sent.
       * [channel.chat.user\_message\_hold](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-user-message-hold) - A user is notified if their message is caught by automod.
       * [channel.chat.user\_message\_update](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-user-message-update) - A user is notified if their message’s automod status is updated.

### 2024-02-01 {#2024-02-01}

The following releases and changes have been made:
1. The Twitch [Game Engine Plugins](https://dev.twitch.tv/docs/game-engine-plugins.md) are now generally available for building integrations in Unity, Unreal, and other C++ engines.
1.  [Get Moderated Channels](https://dev.twitch.tv/docs/api/reference/moderation.md#get-moderated-channels) has moved from public beta to v1. 
1. Made the following changes to specific EventSub references in open beta:

* Events
  * [Channel Guest Star Session End Event](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-session-end) and [Channel Guest Star Session Update Event](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-guest-update):
    * Added three new fields:
      * `host_user_id`
      * `host_user_name`
      * `host_user_login`
    * Updated definitions for all `broadcaster_*` fields to reference the **non-hosting** streamer in a channel:
      * `broadcaster_user_id`
      * `broadcaster_user_name`
      * `broadcaster_user_login`
* Conditions
  * [Channel Guest Star Session End Condition](https://dev.twitch.tv/docs/eventsub/eventsub-reference/#channel-guest-star-session-end-condition-1) and [Channel Guest Star Session Update Condition](https://dev.twitch.tv/docs/eventsub/eventsub-reference/#channel-guest-star-guest-update-condition-1):
    * Updated the definition for `broadcaster_user_id` to refer to the non-hosting broadcaster of the channel.

### 2024-01-25 {#2024-01-25}

This release includes the following updates:

* Conduits
  * Conduit event and transport method features are now generally available. See, [Handling Conduit Events](https://dev.twitch.tv/docs/eventsub/handling-conduit-events.md).
  * Updated [Create EventSub Subscription](https://dev.twitch.tv/docs/api/reference/eventsub.md#create-eventsub-subscription) to include examples for all three supported transport methods types:
    * webhook
    * websocket
    * conduit
  * Added the following Twitch API endpoints and EventSub subscription types:
    * Twitch API:
      * [Create Conduits](https://dev.twitch.tv/docs/api/reference/conduits.md#create-conduits) - Creates a new conduit.
      * [Get Conduits](https://dev.twitch.tv/docs/api/reference/conduits.md#get-conduits) - Retrieves the conduits for a client ID.
      * [Update Conduits](https://dev.twitch.tv/docs/api/reference/conduits.md#update-conduits) - Updates a conduit’s shard count. 
      * [Delete Conduit](https://dev.twitch.tv/docs/api/reference/conduits.md#delete-conduit) - Deletes a conduit.
      * [Get Conduit Shards](https://dev.twitch.tv/docs/api/reference/conduits.md#get-conduit-shards) - Lists all shards for a conduit.
      * [Update Conduit Shards](https://dev.twitch.tv/docs/api/reference/conduits.md#update-conduit-shards) - Updates shard(s) for a conduit.
    * EventSub subscription types:
      * [conduit.shard.disabled](https://dev.twitch.tv/docs/eventsub/reference/conduit.md#conduit-shard-disabled) - Sends a notification when EventSub disables a shard due to the status of the underlying transport changing.
* Chat
  * Added a new Twitch API endpoint:
    * [Send Chat Message](https://dev.twitch.tv/docs/api/reference/chat.md#send-chat-message) - Sends a message to the broadcaster’s chat room.
  * Added new EventSub subscription type:
    * [channel.chat.message](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-message) - Any user sends a message to a specific chat room.

### 2024-01-08 {#2024-01-08}

This release includes the following updates:
- [Get Moderated Channels](https://dev.twitch.tv/docs/api/reference/moderation.md#get-moderated-channels) and [channel.chat_settings.update](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-settings-update) have been added to open beta.
- `user:read:moderated_channels` has been added to the [Twitch API scopes](https://dev.twitch.tv/docs/authentication/scopes.md#twitch-api-scopes).

## 2023

### 2023-12-11 {#2023-12-11}

The following Ads Manager endpoints and subscription type have been moved from open beta to generally available with the following changes, where applicable:
- [Get Ad Schedule](https://dev.twitch.tv/docs/api/reference/ads.md#get-ad-schedule) 
  - `length_seconds` has been renamed to `duration`.
  - `preroll_free_time_seconds` has been renamed to `preroll_free_time`.
- [Snooze Next Ad](https://dev.twitch.tv/docs/api/reference/ads.md#snooze-next-ad)
- [channel.ad_break.begin](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-ad-break-begin)
  - `length_seconds` has been renamed to `duration_seconds`.

### 2023-12-05 {#2023-12-05}

Device Code Flow (DCF) is now generally available.

Refer to [Authentication Overview](https://dev.twitch.tv/docs/authentication.md) and [Device code grant flow](https://dev.twitch.tv/docs/authentication/getting-tokens-oauth.md#device-code-grant-flow) for more information.

### 2023-11-15 {#2023-11-15}

The following EventSub subscription types have been moved from open beta to generally available:

1. [channel.chat.clear](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-clear)
2. [channel.chat.clear_user_messages](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-clear-user-messages)
3. [channel.chat.message_delete](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-message-delete)
4. [channel.chat.notification](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-notification)
  - Additionally, removed `sub.cumulative_months` from the event payload

### 2023-11-07 {#2023-11-07}

Made the following changes to the [channel.chat.notification](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-notification) EventSub subscription type in open beta:

- All instances of `sub_plan` have been renamed to `sub_tier`.
- For the `sub` and `resub` events, the `Prime` value has been removed from `sub_tier`.
- For the `sub` and `resub` events, a new `is_prime` field has been added to indicate if the subscription was purchased through Prime. Prime subs will only have a `sub_tier` value of `1000`.
- A new `badges` field has been added, which returns a list of chat badges.

### 2023-10-19 {#2023-10-19}

Added the following Twitch API endpoints and EventSub subscription types to open beta:

- Chat on Eventsub
  1. [channel.chat.clear](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-clear) - sends a notification when a moderator or bot clears all messages from the chat room.
  2. [channel.chat.clear_user_messages](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-clear-user-messages) - sends a notification when a moderator or bot clears all messages for a specific user.
  3. [channel.chat.message_delete](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-message-delete) - sends a notification when a moderator removes a specific message.
  4. [channel.chat.notification](https://dev.twitch.tv/docs/eventsub/reference/chat.md#channel-chat-notification) - sends a notification when an event that appears in chat occurs, such as someone subscribing to the channel or a subscription is gifted.

- Ads Manager
  1. [Get Ad Schedule](https://dev.twitch.tv/docs/api/reference/ads.md#get-ad-schedule) - Returns ad schedule related information, including snooze, when the last ad was run, when the next ad is scheduled, and if the channel is currently in pre-roll free time.
  2. [Snooze Next Ad](https://dev.twitch.tv/docs/api/reference/ads.md#snooze-next-ad) - Pushes back the timestamp of the upcoming automatic mid-roll ad by 5 minutes.
  3. [channel.ad_break.begin](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-ad-break-begin) - sends a notification when a midroll commercial break begins on a channel.

Added the following [authentication scopes](https://dev.twitch.tv/docs/authentication/scopes.md) for the above API endpoionts and subscription types:

1. `channel:bot` - Allows the client’s bot users access to a channel.
2. `user:bot` - Allows client's bot to act as this user.
3. `user:read:chat` - View live stream chat and room messages. 
4. `channel:manage:ads` - Manage ads schedule on a channel.
5. `channel:read:ads` - Read the ads schedule and details on your channel.

### 2023-10-18 {#2023-10-18}

The [Twitch Drops guide](https://dev.twitch.tv/docs/drops.md) has been updated for the latest version as announced on [Improving the Flexibility of Twitch Drops](https://discuss.dev.twitch.com/t/improving-the-flexibility-of-twitch-drops).

### 2023-09-12 {#2023-09-12}

This release includes the following updates to the [Get Clips](https://dev.twitch.tv/docs/api/reference/clips.md#get-clips) API endpoint:

1. The optional `is_featured` field has been added to the request parameters to allow returning only featured clips, non-featured clips, or both if the parameter is not present.
2. The `is_featured` field has been added to the response body, indicating if the clip is featured or not.

### 2023-09-06 {#2023-09-06}

This release includes the following updates, detailed in the [Legacy Follows API and Eventsub Shutdown Timeline post here](https://discuss.dev.twitch.tv/t/legacy-follows-api-and-eventsub-shutdown-timeline-updated/46769):

1. The Get Users Follows API endpoint has been removed.
2. [Get Channel Followers](https://dev.twitch.tv/docs/api/reference/channels.md#get-channel-followers) now requires the user access token to contain both the **moderator:read:followers** scope and have either the user ID match the `broadcaster_id` or the user must be a moderator for the specified broadcaster in order to return data about specific followers. This condition is also required for using the `user_id` parameter.
2. V1 of [channel.follow](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-follow) has been removed.

### 2023-08-24 {#2023-08-24}

This release includes the following updates:

1. The [Channel Guest Star Guest Update](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-guest-update) notification now sends when a slot is updated, and includes information about the slot, if applicable.
2. The Guest Star Slot Update event has been removed, as its information is now included in the [Channel Guest Star Guest Update](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-guest-update) event.
3. The `moderator:read:guest_star` and `moderator:manage:guest_star` scopes have been added to the following subscription types:
  - [Channel Guest Star Session Begin](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-session-begin)
  - [Channel Guest Star Session End](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-session-end)

### 2023-08-04 {#2023-08-04}

This release includes the following updates:

1. [IRC Tags](https://dev.twitch.tv/docs/irc/tags/#privmsg-tags) for PRIVMSG have been updated to include changes to Chat Replies:
  - Updated existing *reply-parent-\** tags to refer to only referencing their direct parent message
  - Added *reply-thread-parent-msg-id*
  - Added *reply-thread-parent-user-login*
2. [Guest Star Guest Update](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-guest-update) now includes the `accepted` state for when a guest has accepted their invitation to the Guest Star session.

### 2023-07-19 {#2023-07-19}

[IRC Tags](https://dev.twitch.tv/docs/irc/tags/#privmsg-tags) for PRIVMSG have been updated to include Hype Chat.

[Video Broadcast](https://dev.twitch.tv/docs/video-broadcast.md) updated to refer to the latest broadcasting guidelines.

### 2023-07-17 {#2023-07-17}

This release includes the following updates:
1. Moved Version 2 of [channel.update](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-update) from open beta to generally available.
1. The following Twitch API endpoints have been [decommissioned](https://discuss.dev.twitch.tv/t/withdrawal-of-twitch-api-endpoints-for-soundtrack/46021) and removed from documentation:
- "Get Soundtrack Current Track"
- "Get Soundtrack Playlist"
- "Get Soundtrack Playlists"
1. Increased the maximum number of enabled subscriptions per WebSocket connection from 100 to 300.

### 2023-07-10 {#2023-07-10}

This release includes the following updates related to content classification labels and branded content:

1. Made the following changes to [Get Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#get-channel-information):
- Added the <i>content_classification_labels</i> field to the response, which returns the CCLs currently applied to the channel.
- Added the <i>is_branded_content</i> field to the response, which indicates if the channel has branded content.
2. Made the following changes to [Modify Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#modify-channel-information):
- Added the <i>content_classification_labels</i> field to the request body, which lets you enable or disable specific content classification labels for the channel.
- Added the <i>is_branded_content</i> field to the request body, which lets you specify if the channel has branded content.
3. Added the Twitch API endpoint [Get Content Classification Labels](https://dev.twitch.tv/docs/api/reference/ccls.md#get-content-classification-labels), which shows you the available content classification labels.

### 2023-06-29 {#2023-06-29}

Moved the following changes to existing subscription type [channel.update](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-update) to open beta:
- Removed the `is_mature` boolean flag
- Added a new `content_classification_labels` field that lists the IDs of any [content classification labels](https://safety.twitch.tv/s/article/Content-Classification-Guidelines) applied on the channel

### 2023-06-15 {#2023-06-15}

[Authorization Revoked](https://dev.twitch.tv/docs/pubsub/#authorization-revoked) has been added for PubSub.

### 2023-05-22 {#2023-05-22}

This release includes the following updates:

1. Made the following changes to [Get Channel Guest Star Settings](https://dev.twitch.tv/docs/api/reference/guest-star.md#get-channel-guest-star-settings):
- The following [authentication scopes](https://dev.twitch.tv/docs/authentication/scopes.md) have been added
  - `moderator:read:guest_star`
  - `moderator:manage:guest_star`
- A `moderator_id` is now required in the request query parameters

2. Removed the Twitch API v5 Migration Guide

### 2023-05-11 {#2023-05-11}

Added the following Twitch API endpoints and subscription types to open beta:
- [Get Channel Guest Star Settings](https://dev.twitch.tv/docs/api/reference/guest-star.md#get-channel-guest-star-settings) - Gets the channel settings for configuration of the Guest Star feature for a particular host.
- [Update Channel Guest Star Settings](https://dev.twitch.tv/docs/api/reference/guest-star.md#update-channel-guest-star-settings) - Mutates the channel settings for configuration of the Guest Star feature for a particular host.
- [Get Guest Star Session](https://dev.twitch.tv/docs/api/reference/guest-star.md#get-guest-star-session) - Gets information about an ongoing Guest Star session for a particular channel.
- [Create Guest Star Session](https://dev.twitch.tv/docs/api/reference/guest-star.md#create-guest-star-session) - Programmatically creates a Guest Star session on behalf of the broadcaster.
- [End Guest Star Session](https://dev.twitch.tv/docs/api/reference/guest-star.md#end-guest-star-session) - Programmatically ends a Guest Star session on behalf of the broadcaster.
- [Get Guest Star Invites](https://dev.twitch.tv/docs/api/reference/guest-star.md#get-guest-star-invites) - Provides the caller with a list of pending invites to a Guest Star session.
- [Send Guest Star Invite](https://dev.twitch.tv/docs/api/reference/guest-star.md#send-guest-star-invite) - Sends an invite to a specified guest on behalf of the broadcaster for a Guest Star session in progress.
- [Delete Guest Star Invite](https://dev.twitch.tv/docs/api/reference/guest-star.md#delete-guest-star-invite) - Revokes a previously sent invite for a Guest Star session.
- [Assign Guest Star Slot](https://dev.twitch.tv/docs/api/reference/guest-star.md#assign-guest-star-slot) - Allows a previously invited user to be assigned a slot within the active Guest Star session.
- [Update Guest Star Slot](https://dev.twitch.tv/docs/api/reference/guest-star.md#update-guest-star-slot) - Allows a user to update the assigned slot for a particular user within the active Guest Star session.
- [Delete Guest Star Slot](https://dev.twitch.tv/docs/api/reference/guest-star.md#delete-guest-star-slot) - Allows a caller to remove a slot assignment from a user participating in an active Guest Star session.
- [Update Guest Star Slot Settings](https://dev.twitch.tv/docs/api/reference/guest-star.md#update-guest-star-slot-settings) - Allows a user to update slot settings for a particular guest within a Guest Star session.
- [channel.guest_star_session.begin](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-session-begin) - The host began a new Guest Star session.
- [channel.guest_star_session.end](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-session-end) - A running Guest Star session has ended.
- [channel.guest_star_guest.update](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-guest-update) - A guest has moved between interaction states in an active Guest Star session.
- [channel.guest_star_slot.update](https://dev.twitch.tv/docs/eventsub/eventsub-subscription-types/#channelguest_star_slotupdate) - A slot setting has been updated in an active Guest Star session.
- [channel.guest_star_settings.update](https://dev.twitch.tv/docs/eventsub/reference/guest-star.md#channel-guest-star-settings-update) - The host preferences for Guest Star have been updated.

The following [authentication scopes](https://dev.twitch.tv/docs/authentication/scopes.md) have been added:
- `channel:read:guest_star`
- `channel:manage:guest_star`
- `moderator:read:guest_star`
- `moderator:manage:guest_star`

### 2023-04-12 {#2023-04-12}

The EventSub WebSockets connection URL has been updated to `wss://eventsub.wss.twitch.tv/ws`.  See [the announcement](https://discuss.dev.twitch.tv/t/update-required-for-eventsub-websockets-beta-connection-url/45079) for more details.

### 2023-04-05 {#2023-04-05}

Twitch's [CLI](https://dev.twitch.tv/docs/cli.md) has been updated to allow for testing [Reconnect message flow](https://dev.twitch.tv/docs/cli/websocket-event-command.md#testing-reconnect-messages) and [forwarding EventSub events](https://dev.twitch.tv/docs/cli/websocket-event-command.md#forwarding-mock-events-to-clients) to the mock WebSocket server.

### 2023-03-30 {#2023-03-30}

[Get Channel Chat Badges](https://dev.twitch.tv/docs/api/reference/chat.md#get-channel-chat-badges) and [Get Global Chat Badges](https://dev.twitch.tv/docs/api/reference/chat.md#get-global-chat-badges) have been updated to include the following return fields; `title`, `description`, `click_action`, and `click_url`. See [the announcement](https://discuss.dev.twitch.tv/t/legacy-badges-endpoint-shutdown-details-and-timeline-june-2023/44621){:target="_blank"} for more information.

### 2023-03-15 {#2023-03-15}

References to the Twitch Developer Rig have been updated or removed following the [end of support announcement](https://discuss.dev.twitch.tv/t/end-of-support-for-the-twitch-developer-rig/42995){:target="_blank"}.

### 2023-02-28 {#2023-02-28}

This release includes the following updates:

1. [Search Channels](https://dev.twitch.tv/docs/api/reference/search.md#search-channels), [Get Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-streams), [Get Followed Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-followed-streams)  &mdash; Include the following changes:
  - Added customizable tags via a new `tags` field.
  - Deprecated the `tag_ids` field in the response. The response continues to include the field; however, it will only return an empty array.

1. [Get All Stream Tags](https://dev.twitch.tv/docs/api/reference/tags#get-all-stream-tags) and [Get Stream Tags](https://dev.twitch.tv/docs/api/reference/tags#get-stream-tags) &mdash; Include the following change:
  - Deprecated the `tag_ids` field in the response. The response continues to include the field; however, it will only return an empty array. These endpoints will return a 410 response on July 13, 2023

1. Additionally, removed the Replace Stream Tags endpoint.
 
For information about these changes, see [Adding customizable tags to the Twitch API](https://discuss.dev.twitch.tv/t/adding-customizable-tags-to-the-twitch-api/42921).

### 2023-02-27 {#2023-02-27}

"Get Code Status" and "Redeem Code" Twitch API endpoints have been decommissioned and removed from documentation.

### 2023-02-22 {#2023-02-22}

This release includes the following updates:

1. Moved the following Channel Follows endpoints and subscription type from open beta to generally available:
- [Get Followed Channels](https://dev.twitch.tv/docs/api/reference/channels.md#get-followed-channels) — Gets a list of broadcasters that the specified user follows.
- [Get Channel Followers](https://dev.twitch.tv/docs/api/reference/channels.md#get-channel-followers) — Gets a list of users that follow the specified broadcaster.
- [channel.follows](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-follow) — Version 2 of the existing subscription type that will now require the `moderator:read:followers` scope.

1. Added deprecation notices to the following:
- [Get User Follows](https://dev.twitch.tv/docs/api/reference.md#get-users-follows)
- [channel.follows](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-follow) (v1)

1. Updated the [Product Lifecycle](https://dev.twitch.tv/docs/product-lifecycle/) with the above deprecation notice.

### 2023-02-09 {#2023-02-09}

Moved the following Shoutout endpoint and subscription types from open beta to generally available:
  - [Send a Shoutout](https://dev.twitch.tv/docs/api/reference/chat.md#send-a-shoutout) &mdash; This endpoint sends a Shoutout to the specified broadcaster.
  - [channel.shoutout.create](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-shoutout-create) &mdash; This subscription type sends a notification when the specified broadcaster sends a Shoutout.
  - [channel.shoutout.receive](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-shoutout-receive) &mdash; This subscription type sends a notification when the specified broadcaster receives a Shoutout.

### 2023-02-03 {#2023-02-03}

Added the following Twitch API endpoints and subscription types to open beta.
- [Get Followed Channels](https://dev.twitch.tv/docs/api/reference/channels.md#get-followed-channels) — Gets a list of broadcasters that the specified user follows.
- [Get Channel Followers](https://dev.twitch.tv/docs/api/reference/channels.md#get-channel-followers) — Gets a list of users that follow the specified broadcaster.
- [channel.follows](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-follow) (beta) — Beta version of the existing subscription type that will now require the `moderator:read:followers` scope.

`low-trust-users` has been added to [PubSub reference](https://dev.twitch.tv/docs/pubsub).

### 2023-01-19 {#2023-01-19}

This release includes the following updates:

1. Added the following Shoutout endpoint and subscription types to open beta:
  - [Send a Shoutout](https://dev.twitch.tv/docs/api/reference/chat.md#send-a-shoutout) &mdash; This endpoint sends a Shoutout to the specified broadcaster.
  - [channel.shoutout.create](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-shoutout-create) &mdash; This subscription type sends a notification when the specified broadcaster sends a Shoutout.
  - [channel.shoutout.receive](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-shoutout-receive) &mdash; This subscription type sends a notification when the specified broadcaster receives a Shoutout.
1. Moved the following Charity endpoints and subscription types from open beta to generally available:
  - [Get Charity Campaign Donations](https://dev.twitch.tv/docs/api/reference/charity.md#get-charity-campaign-donations) &mdash; Returns the list of donations that users have made to the broadcaster's active charity campaign.
  - [Get Charity Campaign](https://dev.twitch.tv/docs/api/reference/charity.md#get-charity-campaign) &mdash; Gets information about the charity campaign that the broadcaster is running, such as their fundraising goal and the amount that's been donated so far.
  - [channel.charity_campaign.start](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-start) &mdash; Sends a notification when the broadcaster starts a charity campaign.
  - [channel.charity_campaign.progress](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-progress) &mdash; Sends a notification when the broadcaster changes the fundraiser's target goal or when progress is made towards the goal.
  - [channel.charity_campaign.stop](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-stop) &mdash; Sends a notification when the broadcaster stops a charity campaign.
  - [channel.charity_campaign.donate](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-donate) &mdash; Sends an event notification when a user donates to the broadcaster's charity campaign.

### 2023-01-10 {#2023-01-10}

This release includes the following updates:

1. Moved the following Shield Mode endpoints and subscription types from open beta to generally available:
   - [Get Shield Mode Status](https://dev.twitch.tv/docs/api/reference/moderation.md#get-shield-mode-status) &mdash; This endpoint gets the broadcaster's Shield Mode activation status.
   - [Update Shield Mode Status](https://dev.twitch.tv/docs/api/reference/moderation.md#update-shield-mode-status) &mdash; This endpoint activates or deactivates the broadcaster's Shield Mode.
   - [channel.shield_mode.begin](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-shield-mode-begin) &mdash; This subscription type sends a notification when the broadcaster activates Shield Mode.
   - [channel.shield_mode.end](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-shield-mode-end) &mdash; This subscription type sends a notification when the broadcaster deactivates Shield Mode.
1. Added the `tags` field to the following endpoints:
   - [Get Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-streams)
   - [Get Followed Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-followed-streams)
   - [Search Channels](https://dev.twitch.tv/docs/api/reference/search.md#search-channels)
   - [Get Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#get-channel-information)
   
   The `tags` field contains the tags that the broadcaster or Twitch added to help identify the content that the broadcaster streams.
1. Added the `tags` field to the [Modify Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#modify-channel-information) endpoint to let broadcasters add or remove tags. Broadcasters use the tags to help identify the content that they stream.
1. Added the `id` field to the [Get Charity Campaign Donations](https://dev.twitch.tv/docs/api/reference/charity.md#get-charity-campaign-donations) response to identify the donation.
1. Added the `id` field to the [Charity Donation](https://dev.twitch.tv/docs/eventsub/eventsub-reference#charity-donation-event) event data to identify the donation.

## 2022

### 2022-12-09 {#2022-12-09}

This release includes the following updates:

1. Added the following missing status values that [Get EventSub Subscriptions](https://dev.twitch.tv/docs/api/reference/eventsub.md#get-eventsub-subscriptions) may return in the `status` field. All of these statuses indicate that the subscription is now disabled. You may also use the status values to filter the list of subscriptions that Get EventSub Subscriptions returns.
   - **websocket_disconnected** &mdash; The client closed the connection.
   - **websocket_failed_ping_pong** &mdash; The client failed to respond to a ping message.
   - **websocket_received_inbound_traffic** &mdash; The client sent a non-pong message. Clients may only send pong messages (and only in response to a ping message).
   - **websocket_connection_unused** &mdash; The client failed to subscribe to events within the required time.
   - **websocket_internal_error** &mdash; The Twitch WebSocket server experienced an unexpected error.
   - **websocket_network_timeout** &mdash; The Twitch WebSocket server timed out writing the message to the client.
   - **websocket_network_error** &mdash; The Twitch WebSocket server experienced a network error writing the message to the client.
   - **moderator_removed** &mdash; The moderator that authorized the subscription is no longer one of the broadcaster's moderators.

### 2022-12-05 {#2022-12-05}

This release updates Twitch's [CLI](https://dev.twitch.tv/docs/cli.md) with the following changes:

1. Adds the following events that you can trigger (see [Testing webhook events](https://dev.twitch.tv/docs/cli/event-command.md)).
   - `charity-donation` &mdash; Triggers an event to mimic when a user donations to the broadcaster's charity campaign.
   - `charity-start` &mdash; Triggers an event to mimic when a broadcaster starts a charity campaign.
   - `charity-progress` &mdash; Triggers an event to mimic when progress is made towards the campaign's goal or when the broadcaster changes the fundraising goal.
   - `charity-stop` &mdash; Triggers an event to mimic when a broadcaster stops a charity campaign.
2. Adds the following flags that you can use with the charity events.
   - `charity-current-value` &mdash; Use to specify the amount of money that's donated for charity donation events or the current amount raised for the charity campaign events.
   - `charity-target-value` &mdash; Use to specify the fundraising target amount for the charity campaign events.
3. Changed the `user.update` event name in the documentation to `user-update` to match the convention used by the other events.

### 2022-12-02 {#2022-12-02}

This release includes the following updates to the Twitch [endpoints](https://dev.twitch.tv/docs/api/reference.md):

1. Added the [Update Shield Mode Status](https://dev.twitch.tv/docs/api/reference/moderation.md#update-shield-mode-status) endpoint, which activates or deactivates the broadcaster's Shield Mode. Twitch's Shield Mode feature is like a panic button that broadcasters can push to protect themselves from chat abuse coming from one or more accounts. When activated, Shield Mode applies the overrides that the broadcaster configured in the Twitch UX. If the broadcaster hasn't configured Shield Mode, it applies default overrides.
2. Added the [Get Shield Mode Status](https://dev.twitch.tv/docs/api/reference/moderation.md#get-shield-mode-status) endpoint, which gets the broadcaster's Shield Mode activation status.
3. Updated the status of the [Get Chatters](https://dev.twitch.tv/docs/api/reference/chat.md#get-chatters) endpoint from Beta to generally available.

This release includes the following updates to the EventSub [subscription types](https://dev.twitch.tv/docs/eventsub/reference.md):

1. Added the [channel.shield_mode.begin](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-shield-mode-begin) subscription type, which sends a notification when the broadcaster activates Shield Mode.
2. Added the [channel.shield_mode.end](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-shield-mode-begin) subscription type, which sends a notification when the broadcaster deactivates Shield Mode.

### 2022-11-29 {#2022-11-29}

Updated the [Get Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#get-channel-information) endpoint to require a user access token to return the Partner's stream delay value (see the `delay` field). By default, the `delay` field's value is zero.

### 2022-11-22 {#2022-11-22}

Updated the [channel.charity_campaign.stop](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-stop) subscription type to include the following fields:

- `charity_name`
- `charity_description`
- `charity_logo`
- `charity_website`

Updated the [channel.charity_campaign.donate](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-donate) and 
[channel.charity_campaign.progress](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-progress) subscription types to include the following fields:

- `charity_description`
- `charity_website`

### 2022-11-21 {#2022-11-21}

Added the [IGDB](https://www.igdb.com/) ID to the [Get Games](https://dev.twitch.tv/docs/api/reference/games.md#get-games) and [Get Top Games](https://dev.twitch.tv/docs/api/reference/games.md#get-top-games) responses (see the `igdb_id` field).

Updated the Get Games endpoint to let you search by IGDB ID.

### 2022-11-17 {#2022-11-17}

Added the `user_id` and `user_name` fields to the [Get Chatters](https://dev.twitch.tv/docs/api/reference/chat.md#get-chatters) response.

Added the [Get Charity Campaign Donations](https://dev.twitch.tv/docs/api/reference/charity.md#get-charity-campaign-donations) endpoint, which returns the list of donations that users have made to the broadcaster's active charity campaign.

Added the following subscription types to [EventSub](https://dev.twitch.tv/docs/eventsub.md).

- [channel.charity_campaign.start](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-start) &mdash; Sends a notification when the broadcaster starts a charity campaign.
- [channel.charity_campaign.progress](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-progress) &mdash; Sends a notification when the broadcaster changes the fundraiser's target goal or when progress is made towards the goal.
- [channel.charity_campaign.stop](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-stop) &mdash; Sends a notification when the broadcaster stops a charity campaign.

- Added `version_removed` as a possible status value to EventSub. The subscription's `status` field is set to `version_removed` if EventSub stops supporting the subscribed to subscription type and version. EventSub sends the status in a revocation message.

### 2022-11-04 {#2022-11-04}

This release includes the following updates:

1. Updated the CLI's [Generating Mock Data and Starting the Server](https://dev.twitch.tv/docs/cli/mock-api-command.md) topic to remove the erroneous `user_id` parameter from the table under **Getting an app access token**.
  
2. Updated the [Get Hype Train Events](https://dev.twitch.tv/docs/api/reference.md#get-hype-train-events) endpoint to include the following new contribution type:
   
   - OTHER &mdash; Covers contribution methods other than Bits and Subscriptions. See the `type` field under the `last_contribution` and `top_contributions` fields.
   
   Updated the [begin](https://dev.twitch.tv/docs/eventsub/eventsub-reference#hype-train-begin-event), [progress](https://dev.twitch.tv/docs/eventsub/eventsub-reference#hype-train-progress-event), and [end](https://dev.twitch.tv/docs/eventsub/eventsub-reference#hype-train-end-event) Hype Train events to include the following new contribution type:
   
   - other &mdash; Covers contribution methods other than Bits and Subscriptions. See the `type` field under the `last_contribution` and `top_contributions` fields.
  
3. Added the [Broadcast Scheduling Guide](https://dev.twitch.tv/docs/api/schedule.md).

### 2022-11-02 {#2022-11-02}

Updated the [channel.charity_campaign.donate](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-donate) subscription type to include the following fields in the event's data:

- `charity_name` &mdash; The charity's name.
- `charity_logo` &mdash; A URL to the charity's logo.

### 2022-11-01 {#2022-11-01}

Added WebSocket support for [EventSub](https://dev.twitch.tv/docs/eventsub.md) notifications. See [Handling WebSocket Events](https://dev.twitch.tv/docs/eventsub/handling-websocket-events.md).

Updated the [Twitch CLI](https://dev.twitch.tv/docs/cli.md) to support testing your WebSocket client (you'll need to upgrade to the latest version). The server sends the client a [welcome](https://dev.twitch.tv/docs/eventsub/handling-websocket-events.md#welcome-message) message followed by [ping](https://dev.twitch.tv/docs/eventsub/handling-websocket-events.md#ping-message) and [keepalive](https://dev.twitch.tv/docs/eventsub/handling-websocket-events.md#keepalive-message) messages. You'll mostly use the mock server to send a [reconnect](https://dev.twitch.tv/docs/eventsub/handling-websocket-events.md#reconnect-message) message to test your client's reconnect code flow. For details, see the [start-websocket-server](https://dev.twitch.tv/docs/cli/websocket-event-command.md) sub-command.

Updated the [Transport](https://dev.twitch.tv/docs/eventsub/eventsub-reference/#transport) object that you use to [subscribe](https://dev.twitch.tv/docs/api/reference/eventsub.md#create-eventsub-subscription) to events:

- Added **websocket** as a possible value to the `method` field.
- Require the `callback` field only if the `method` field is set to **webhook**.
- Require the `secret` field only if the `method` field is set to **webhook**.
- Add the `session_id` field, which identifies the WebSocket to send notifications to. This field is required only if the `method` field is set to **websocket**.
- Added the `connected_at` field, which contains the UTC date and time that the WebSocket connection was established. This is a response-only field that [Create EventSub Subscription](https://dev.twitch.tv/docs/api/reference/eventsub.md#create-eventsub-subscription) and [Get EventSub Subscription](https://dev.twitch.tv/docs/api/reference/eventsub.md#get-eventsub-subscriptions) returns if the `method` field is set to **websocket**.
- Added the `disconnected_at` field, which contains the UTC date and time that the WebSocket connection was lost. This is a response-only field that [Get EventSub Subscription](https://dev.twitch.tv/docs/api/reference/eventsub.md#get-eventsub-subscriptions) returns if the `method` field is set to **websocket**.

### 2022-09-29 {#2022-09-29}

Added the [Get Chatters](https://dev.twitch.tv/docs/api/reference/chat.md#get-chatters) endpoint, which you use to get the list of users that are connected to the specified broadcaster's chat session.

### 2022-09-16 {#2022-09-16}

**Breaking change to the Beta [channel.charity_campaign.donate](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-donate) EventSub subscription type**:

The `id` field of the [Charity Donation Event](https://dev.twitch.tv/docs/eventsub/eventsub-reference/#charity-donation-event) object will change to `campaign_id` to better reflect its content on Tuesday, September 20 at 1:00pm PDT.

### 2022-09-01 {#2022-09-01}

Updated the [Create Poll](https://dev.twitch.tv/docs/api/reference/polls.md#create-poll) endpoint to remove support for voting with Bits. This change removes the following optional request fields from the documentation:

- `bits_voting_enabled`
- `bits_per_vote`

If your request includes these fields, the endpoint ignores them. The following response fields will be set to default values.

- `bits_votes` &mdash; set to 0.
- `bits_voting_enabled` &mdash; set to **false**.
- `bits_per_vote` &mdash; set to 0.

The [Get Polls](https://dev.twitch.tv/docs/api/reference/polls.md#get-polls) and [End Poll](https://dev.twitch.tv/docs/api/reference/polls.md#end-poll) responses will show the above values for polls created on or after August 29, 2022; otherwise, the response contains Bits values if enabled.

The above Bits-related fields should also be ignored for the following EventSub events:

- [channel.poll.begin](https://dev.twitch.tv/docs/eventsub/reference/poll.md#channel-poll-begin)
- [channel.poll.progress](https://dev.twitch.tv/docs/eventsub/reference/poll.md#channel-poll-progress)
- [channel.poll.end](https://dev.twitch.tv/docs/eventsub/reference/poll.md#channel-poll-end)

### 2022-08-26 {#2022-08-26}

Added the `vip` tag to [PRIVMSG](https://dev.twitch.tv/docs/irc/tags#privmsg-tags). You can use the tag to determine whether the user that sent the chat is a VIP.

### 2022-08-25 {#2022-08-25}

Adds the following API and subscription type that you can use to get information about the charity campaign that the broadcaster is running.

- [Get Charity Campaign](https://dev.twitch.tv/docs/api/reference/charity.md#get-charity-campaign) &mdash; Gets information about the charity campaign that the broadcaster is running, such as their fundraising goal and the amount that's been donated so far.
- [channel.charity_campaign.donate](https://dev.twitch.tv/docs/eventsub/reference/charity.md#channel-charity-campaign-donate) &mdash; Sends an event notification when a user donates to the broadcaster's charity campaign.

### 2022-08-12 {#2022-08-12}

Added the [Moderation Guide](https://dev.twitch.tv/docs/api/moderation) that shows how to use the moderation APIs such as adding and removing moderators, banning users or putting them in a timeout, and updating your AutoMod settings.

### 2022-07-29 {#2022-07-29}

All Twitch API endpoints introduced on 2022-07-15 have moved from public beta to general availability.

### 2022-07-22 {#2022-07-22}

Added the following guides:

- [Creating Clips](https://dev.twitch.tv/docs/api/clips.md) &mdash; Shows how to create and get clips.
- [Creating Markers](https://dev.twitch.tv/docs/api/markers.md) &mdash; Shows how to create and get stream markers.

### 2022-07-20 {#2022-07-20}

Added the `vod_offset` field to the [Get Clips](https://dev.twitch.tv/docs/api/reference/clips.md#get-clips) API response. The offset is the number of seconds from the start of the video to the beginning of the clip.

Updated the list of possible values that the `type` field in the [Get Creator Goals](https://dev.twitch.tv/docs/api/reference/goals.md#get-creator-goals) API response may be set to. The following values were added to the list:

- subscription_count &mdash; The goal is to increase subscriptions. This type shows the net increase or decrease in the number of subscriptions. 
- new_subscription_count &mdash; The goal is to increase subscriptions. This type shows only the net increase in the number of subscriptions (it does not account for users that unsubscribed since the goal started).

### 2022-07-15 {#2022-07-15}

This release adds the following endpoints. See :

- [Send Chat Announcement](https://dev.twitch.tv/docs/api/reference/chat.md#send-chat-announcement) &mdash; Sends an announcement to the broadcaster's chat room.
- [Delete Chat Messages](https://dev.twitch.tv/docs/api/reference/moderation.md#delete-chat-messages) &mdash; Removes a single chat message or all chat messages from the broadcaster's chat room.
- [Update User Chat Color](https://dev.twitch.tv/docs/api/reference/chat.md#update-user-chat-color) &mdash; Updates the color used for the user's name in chat.
- [Get User Chat Color](https://dev.twitch.tv/docs/api/reference/chat.md#get-user-chat-color) &mdash; Gets the color used for the user's name in chat.
- [Add Channel Moderator](https://dev.twitch.tv/docs/api/reference/moderation.md#add-channel-moderator) &mdash; Adds a moderator to the broadcaster's chat room.
- [Remove Channel Moderator](https://dev.twitch.tv/docs/api/reference/moderation.md#remove-channel-moderator) &mdash; Removes a moderator from the broadcaster's chat room.
- [Get VIPs](https://dev.twitch.tv/docs/api/reference/moderation.md#get-vips) &mdash; Gets a list of the channel's VIPs.
- [Add Channel VIP](https://dev.twitch.tv/docs/api/reference/moderation.md#add-channel-vip) &mdash; Adds a VIP to the broadcaster's chat room.
- [Remove Channel VIP](https://dev.twitch.tv/docs/api/reference/moderation.md#remove-channel-vip) &mdash; Removes a VIP from the broadcaster's chat room.
- [Send Whisper](https://dev.twitch.tv/docs/api/reference/whispers.md#send-whisper) &mdash; Sends a whisper message to the specified user.

The following [authentication scopes](https://dev.twitch.tv/docs/authentication/scopes.md) have also been added for the endpoints above:
- `moderator:manage:announcements`
- `moderator:manage:chat_messages`
- `user:manage:chat_color`
- `channel:manage:moderators`
- `channel:read:vips`
- `channel:manage:vips`
- `user:manage:whispers`

### 2022-07-11 {#2022-07-11}

[Submission Best Practices](https://dev.twitch.tv/docs/extensions/submission-best-practices.md) - Updated the "Content in Extensions" section to define the expected functionality of global overlay Extensions and examples.

### 2022-06-29 {#2022-06-29}

[Twitch API](https://dev.twitch.tv/docs/api.md) - Organization and content for this section has been improved for a better developer experience.

[Twitch Drops](https://dev.twitch.tv/docs/ja/drops.md) - Japanese localization added.

### 2022-06-27 {#2022-06-27}

[Check AutoMod Status](https://dev.twitch.tv/docs/api/reference/moderation.md#check-automod-status) &mdash; Includes the following changes:

- Deprecated and removed the `user_id` field from the request body. The endpoint ignores the field if you include it.
- Added endpoint-specific rate limits.

For information about these changes, see [Upcoming changes to the Check AutoMod Status API](https://discuss.dev.twitch.tv/t/upcoming-changes-to-the-check-automod-status-api-endpoint/38512).

[Get Users](https://dev.twitch.tv/docs/api/reference/users.md#get-users) &mdash; Includes the following change:

- Deprecated the `view_count` field in the response. The response continues to include the field; however, it contains stale data. You should stop displaying this data at your earliest convenience.

[Start a Raid](https://dev.twitch.tv/docs/api/reference/raids.md#start-a-raid), [Cancel a Raid](https://dev.twitch.tv/docs/api/reference/raids.md#cancel-a-raid) &mdash; Includes the following change:

- These endpoints were removed from Beta and are now generally available (replaced the Beta tag to New).

[Get EventSub Subscriptions](https://dev.twitch.tv/docs/api/reference/eventsub.md#get-eventsub-subscriptions) &mdash; Includes the following change:

- Added the *user_id* query parameter that you can use to filter your list of subscriptions by. The response contains subscriptions where the user ID matches a user ID that you specified in the **Condition** object when you [created the subscription](https://dev.twitch.tv/docs/api/reference/eventsub.md#create-eventsub-subscription).

**BREAKING CHANGES**

[Get Soundtrack Playlist](https://dev.twitch.tv/docs/api/reference.md#get-soundtrack-playlist) &mdash; Removed the following playlist fields from the response:

- `description`
- `id`
- `image_url`
- `title`
- `tracks` (the `data` field now contains the playlist's tracks)

[Get Soundtrack Playlists](https://dev.twitch.tv/docs/api/reference.md#get-soundtrack-playlists) &mdash; Added the *id* query parameter, which you can use to get metadata information about a single playlist.

### 2022-06-08 {#2022-06-08}

Added the ability for your application to start or cancel a raid. [Read more](https://dev.twitch.tv/docs/api/raids.md)

This update adds the following endpoints:

- [Start a Raid](https://dev.twitch.tv/docs/api/reference/raids.md#start-a-raid)
- [Cancel a Raid](https://dev.twitch.tv/docs/api/reference/raids.md#cancel-a-raid)

Added the `created_at` field to the response object of the following endpoints:

- [Ban User](https://dev.twitch.tv/docs/api/reference/moderation.md#ban-user)
- [Get Banned Users](https://dev.twitch.tv/docs/api/reference/moderation.md#get-banned-users)

### 2022-06-02 {#2022-06-02}

[Create Prediction](https://dev.twitch.tv/docs/api/reference/predictions.md#create-prediction) - Updated to allow specifying up to ten outcomes.

### 2022-05-17 {#2022-05-17}

Added fields to the following EventSub subscription types:

- [user.update](https://dev.twitch.tv/docs/eventsub/reference/user.md#user-update) &mdash; Added the `email_verified` field, which indicates whether Twitch has verified the user's email. 
- [channel.ban](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-ban) &mdash; Added the `banned_at` field, which indicates the UTC date and time of when the user was banned or put in a timeout.
- [channel.hype_train.begin](https://dev.twitch.tv/docs/eventsub/reference/hype-train.md#channel-hype-train-begin) &mdash; Added the `level` field, which indicates the level at which the Hype Train started.

[Extension Guidelines and Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md) - Added section 4.11 regarding NFTs in Twitch Extensions.

### 2022-05-09 {#2022-05-09}

[Extension Submission Best Practices](https://dev.twitch.tv/docs/extensions/submission-best-practices.md)
- Added a section for content in Extensions
- Amended the quicker reviews section with information regarding what types of domains are valid for an Extension's content security policy allowlists.

[Extension Guidelines and Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md)
- Added section 4.10 regarding global overlay Extensions. See more details in [our announcement](https://discuss.dev.twitch.tv/t/new-extensions-policy-for-global-overlay-extensions/37286/8){: target="_blank" }.
- Added section 2.13 to regarding what types of domains are valid for an Extension's content security policy allowlists

### 2022-04-29 {#2022-04-29}

[Chat & Chatbots](https://dev.twitch.tv/docs/irc) - Organization and content for this section has been improved for a better developer experience.

### 2022-04-13 {#2022-04-13}

Added 409 Conflict as a possible response code to [Ban User](https://dev.twitch.tv/docs/api/reference/moderation.md#ban-user) and [Unban User](https://dev.twitch.tv/docs/api/reference/moderation.md#unban-user).

Added information about when the Twitch API may introduce breaking and non-breaking changes to the API. For details, see [Breaking Changes](https://dev.twitch.tv/docs/api/guide.md#breaking-changes).

### 2022-04-12 {#2022-04-12}

Enhanced Experiences and Event-based Drops have been [decommissioned](https://discuss.dev.twitch.tv/c/announcements){: target="_blank" } and documentation has been removed.

### 2022-04-07 {#2022-04-07}

[Authentication](https://dev.twitch.tv/docs/authentication.md) - Organization and writing for this section has been improved for a better developer experience.

[Get Hype Train Events](https://dev.twitch.tv/docs/api/reference.md#get-hype-train-events) - Removed `id` query parameter. See the [deprecation announcement](https://discuss.dev.twitch.tv/t/get-hype-train-events-api-endpoint-id-query-parameter-deprecation/37613){: target="_blank" } for more information.

### 2022-03-18 {#2022-03-18}

Removed documentation for "Get Banned Events" and "Get Moderator Events" Twitch API endpoints. For more information about the deprecation and removal of these endpoints, see the [deprecation announcement](https://discuss.dev.twitch.tv/t/deprecation-of-twitch-api-event-endpoints-that-supported-websub-based-webhooks/35137){: target="_blank" }.

### 2022-02-28 {#2022-02-28}

Twitch API v5 endpoints (i.e. kraken) are no longer available. Documentation for these endpoints have been removed.

### 2022-02-25 {#2022-02-25}

[Chat msg-id tags](https://dev.twitch.tv/docs/irc/msg-id) updated for accuracy.

### 2022-02-11 {#2022-02-11}

Updated the [Chatbots](https://dev.twitch.tv/docs/irc) content with the following changes:

- Replaced the /r9kbeta and /r9kbetaoff [Twitch chat commands](https://dev.twitch.tv/docs/irc/chat-commands) to /uniquechat and /uniquechatoff, respectively, to match the commands used in Twitch Chat. The /r9kbeta and /r9kbetaoff continue to work but you should start using /uniquechat and /uniquechatoff at your earliest convenience.

- Removed the following tags from the list of possible [USERNOTICE tags](https://dev.twitch.tv/docs/irc/tags#usernotice-tags):

  - anonsubgift
  - anonsubmysterygift

- Added the `WHISPER` command to the [list of commands](https://dev.twitch.tv/docs/irc/commands#whisper) that the Twitch IRC server may send your bot.

### 2022-02-08 {#2022-02-08}

[Get channel information](https://dev.twitch.tv/docs/api/reference/channels.md#get-channel-information) endpoint

- Changed the description for the `broadcaster_id` query parameter to indicate that you may specify a maximum of 100 IDs. 

[Get Soundtrack Current Track](https://dev.twitch.tv/docs/api/reference.md#get-soundtrack-current-track) endpoint

- Changed the description for the `data` response field to remove the part that states that the list is empty if the broadcaster is not playing a track. The correct behavior is that if the broadcaster is not playing a track, the endpoint returns HTTP status code 404 Not Found.
- Changed the description for the `creator_channel_id` response field to indicate that its value is an empty string if a Twitch user didn't create the track instead of **null**.

[Get Soundtrack Playlist](https://dev.twitch.tv/docs/api/reference.md#get-soundtrack-playlist) endpoint

- Changed the description for the `creator_channel_id` response field to indicate that its value is an empty string if a Twitch user didn't create the track instead of **null**.

[Extension Policy 2.9](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md) updated to clarify that the Twitch Extension Helper must be included as the first script in all front-end HTML files.

### 2022-01-21 {#2022-01-21}

[Restrictions on content](https://dev.twitch.tv/docs/extensions.md#restrictions-on-content) updated to reflect the new Twitch Extensions policy for [Content Security Policy (CSP) directives and enforcement](https://discuss.dev.twitch.tv/t/new-extensions-policy-for-content-security-policy-csp-directives-and-timeline-for-enforcement/33695){: target="_blank" }.

[Moderation API endpoints](https://dev.twitch.tv/docs/api/reference/moderation.md#ban-user) have moved from public beta to generally available.

### 2022-01-06 {#2022-01-06}

Added the `new_subscription` Creator Goals type, which reports all new subscriptions since the goal's inception. This type differs from the `subscription` type, which reports the net increase or decrease in subscriptions. See the `type` field of:

- [Goals Event](https://dev.twitch.tv/docs/eventsub/eventsub-reference#goals-event)
- [Get Creator Goals](https://dev.twitch.tv/docs/api/reference/goals.md#get-creator-goals)

## 2021

### 2021-12-16 {#2021-12-16}

The [Update Chat Settings](https://dev.twitch.tv/docs/api/reference/chat.md#update-chat-settings) endpoint now lets you:

- Set the `follower_mode_duration` field to any value between 0 and 129600, inclusive.
- Set the `slow_mode_wait_time` field to any value between 3 and 120, inclusive.

Open beta changes:
- For [Ban Users](https://dev.twitch.tv/docs/api/reference/moderation.md#ban-user), bulk requests have been removed until a more scalable solution is available.
- For [Ban Users](https://dev.twitch.tv/docs/api/reference/moderation.md#ban-user) and [Unban User](https://dev.twitch.tv/docs/api/reference/moderation.md#unban-user), error message formatting now utilizes the same structure as other API endpoints since bulk requests have been removed. HTTP 429 errors may also be returned if there are too many requests even within normal Twitch API rate limits.

### 2021-12-09 {#2021-12-09}

Added the following Soundtrack APIs:

1. [Get Soundtrack Current Track](https://dev.twitch.tv/docs/api/reference.md#get-soundtrack-current-track) &mdash; Gets the Soundtrack track that the specified broadcaster is playing.
1. [Get Soundtrack Playlists](https://dev.twitch.tv/docs/api/reference.md#get-soundtrack-playlists) &mdash; Gets the list of Soundtrack playlists.
1. [Get Soundtrack Playlist](https://dev.twitch.tv/docs/api/reference.md#get-soundtrack-playlist) &mdash; Gets the specified Soundtrack playlist.

### 2021-12-03 {#2021-12-03}

Updated [Organizations](https://dev.twitch.tv/docs/companies.md) to reflect [cover art powered by IGDB](https://discuss.dev.twitch.tv/c/announcements){: target="_blank" }.

Updates [Product Lifecycle](https://dev.twitch.tv/docs/product-lifecycle) to include [the deprecation](https://discuss.dev.twitch.tv/t/deprecation-of-twitch-api-event-endpoints-that-supported-websub-based-webhooks/35137){: target="_blank" } of a few Twitch API endpoints that supported WebSub-based webhooks.

### 2021-11-23 {#2021-11-23}

Added the following chat and moderation APIs that let developers create experiences that help broadcasters combat harassment and hate raids.

|What do you want to do?|How to do it...
|-|-
|Ban users or put them in a timeout|Send a [POST /moderation/bans](https://dev.twitch.tv/docs/api/reference/moderation.md#ban-user) request. You can also [remove](https://dev.twitch.tv/docs/api/reference/moderation.md#unban-user) a ban or timeout.
|Block terms that the broadcaster doesn't want used in their chat room|Send a [POST /moderation/blocked_terms](https://dev.twitch.tv/docs/api/reference/moderation.md#add-blocked-term) request. You can also [get](https://dev.twitch.tv/docs/api/reference/moderation.md#get-blocked-terms) a list of blocked terms and [delete](https://dev.twitch.tv/docs/api/reference/moderation.md#remove-blocked-term) blocked terms.
|Update the broadcaster's AutoMod settings|Send a [PUT /moderation/automod/settings](https://dev.twitch.tv/docs/api/reference/moderation.md#update-automod-settings) request. You can also [get](https://dev.twitch.tv/docs/api/reference/moderation.md#get-automod-settings) a list of the current AutoMod settings.
|Update the broadcaster's chat settings|Send a [PATCH /chat/settings](https://dev.twitch.tv/docs/api/reference/chat.md#update-chat-settings) request. You can also [get](https://dev.twitch.tv/docs/api/reference/chat.md#get-chat-settings) a list of the current chat settings.

### 2021-11-09 {#2021-11-09}

Reorganization of EventSub documentation, moving [handling events](https://dev.twitch.tv/docs/eventsub/handling-webhook-events.md) to a dedicated page.

Explicitly including the "Content-Type: application/json" header in [API reference](https://dev.twitch.tv/docs/api/reference.md) examples.

### 2021-10-27 {#2021-10-27}

[Organization Management](https://dev.twitch.tv/docs/companies.md) updated to reflect IGDB will power Twitch game cover art as of November 17, 2021.

### 2021-10-20 {#2021-10-20}

Added documenation for Twitch's [command-line interface](https://dev.twitch.tv/docs/cli.md) (CLI).

### 2021-10-01 {#2021-10-01}

Added the `points` field to the [Get Broadcaster Subscriptions](https://dev.twitch.tv/docs/api/reference/subscriptions.md#get-broadcaster-subscriptions) response. This field provides the current number of subscriber points earned by this broadcaster.

### 2021-09-30 {#2021-09-30}

[Extensions Policy 2.12](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md) has been added in regards to defining the domains from which Twitch Extensions can load content. More information is available in the announcement, [New Extensions policy for Content Security Policy (CSP) directives and timeline for enforcement](https://discuss.dev.twitch.tv/c/announcements/13).

[Get started with Twitch Extensions](https://dev.twitch.tv/docs/extensions.md) - "Restrictions on content" section updated to reflect Extensions policy 2.12 and the timeline mentioned in the announcement.

### 2021-09-29 {#2021-09-29}

[Drops Guide](https://dev.twitch.tv/docs/drops.md) received minor updates.

### 2021-09-24 {#2021-09-24}

Reformatted Goals [EventSub Subscription Types](https://dev.twitch.tv/docs/eventsub/reference.md) for consistency.

Retitled the "Get Live Channels" to "[Get Extension Live Channels](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extension-live-channels)" to clarify the endpoint is specific to Extensions activated on live channels.

### 2021-09-16 {#2021-09-16}

Decommissioned WebSub-based webhooks, which resulted in the following documentation changes:

* Removed the **Get Webhook Subscriptions** endpoint from the [reference](https://dev.twitch.tv/docs/api/reference.md).
* Deleted the Webhooks Guide and Webhooks Reference topics.
* Updated the [Product Lifecycle](https://dev.twitch.tv/docs/product-lifecycle) topic to note the date that WebSub-based webhooks was decommissioned.

### 2021-09-15 {#2021-09-15}

The Creator Goals feature is now generally available. Broadcasters create goals to generate hype in their community, and it provides the community a way to support the channel. Goals can be daily goals, subathons, or anything in between. For information about using the API to get goals or receive notifications about goals, see [Creator Goals](https://dev.twitch.tv/docs/api/goals.md).

### 2021-09-10 {#2021-09-10}

Minor updates to address [GitHub Issues](https://github.com/twitchdev/issues/issues?q=is%3Aissue+is%3Aopen+label%3A%22product%3A+docs%22).

[Insights & Analytics](https://dev.twitch.tv/docs/insights.md) – Directions to access Drops Analytics has been updated and the "Top Streamers" report has been removed.

### 2021-09-01 {#2021-09-01}

Added the Creator Goals API, which returns active goals that broadcasters create on Twitch. Broadcasters create these goals to generate hype in their community, and it provides the community a way to support the channel. Goals can be daily goals, subathons, or anything in between. For more information, see [Creator Goals](https://dev.twitch.tv/docs/api/goals.md).

### 2021-08-30 {#2021-08-30}

[Twitch API Guide](https://dev.twitch.tv/docs/api/guide.md) - Technical concepts in this guide have been updated or added to for further clarification.

[Embedding Twitch](https://dev.twitch.tv/docs/embed.md) - Updated to include that certain features may be disabled if the embedded iframe is obscured.

[Embedding Video and Clips](https://dev.twitch.tv/docs/embed/video-and-clips.md) - Updated description for `seek` function and added the SEEK event.

### 2021-08-20 {#2021-08-20}

Updated examples for [validating](https://dev.twitch.tv/docs/authentication/validate-tokens.md) and [revoking](https://dev.twitch.tv/docs/authentication/revoke-tokens.md) OAuth tokens.

Updated [Extension Helper Library](https://dev.twitch.tv/docs/extensions/building.md#extension-helper-library) to clarify that all HTML files should include the Extension Helper.

### 2021-08-13 {#2021-08-13}

Added the following fields to the [Get Channel Emotes](https://dev.twitch.tv/docs/api/reference/chat.md#get-channel-emotes), [Get Global Emotes](https://dev.twitch.tv/docs/api/reference/chat.md#get-global-emotes), and [Get Emote Sets](https://dev.twitch.tv/docs/api/reference/chat.md#get-emote-sets) endpoints.

- `format` &mdash; The formats that the emote is available in. For example, PNG or animated GIF.
- `scale` &mdash; The sizes that the emote is available in. For example, 1.0 (small).
- `theme_mode` &mdash; The background themes that the emote is available in. For example, light.
- `template` &mdash; The URL template that you use to create a URL for fetching the emote.

For information about how to use these fields, see [Twitch Emotes](https://dev.twitch.tv/docs/irc/emotes).

Added the following to the [Chatbots & IRC Guide](https://dev.twitch.tv/docs/irc).

- Existing site-wide rate limit for verified bots
- Clarification in the `JOIN` section regarding expected behavior when exceeding rate limits for joining channels

### 2021-07-30 {#2021-07-30}

[Get Started with the Twitch API](https://dev.twitch.tv/docs/api.md) - This API guide has been updated to use the Twitch CLI and simplify how to retrieve an OAuth token to improve the getting started experience.

### 2021-07-27 {#2021-07-27}

The Create and Delete Follows API endpoints have been removed. See the [Deprecation of Create and Delete Follows API Endpoints](https://discuss.dev.twitch.tv/t/deprecation-of-create-and-delete-follows-api-endpoints/32351) announcement for more information.

### 2021-07-26 {#2021-07-26}

[Twitch Chat Guide](https://dev.twitch.tv/docs/irc#verified-bots) - Updated information regarding verified chatbots including rate limits. Known bots have been removed. More information can be found in the [chatbot verification update announcement](https://discuss.dev.twitch.tv/t/an-update-for-the-delayed-bot-verification-request-process/32325).

### 2021-07-23 {#2021-07-23}

[Get Banned Users](https://dev.twitch.tv/docs/api/reference/moderation.md#get-banned-users) and "Get Banned Events" updated to include ban reason and information for the moderator who initiated the ban.

[Twitch Emotes Guide](https://dev.twitch.tv/docs/irc/emotes/) - Added to document how developers can customize Twitch Emote image URLs to optimize their rendering in third-party applications.

With the addition of the guide above, the "Chatbots & IRC" navigation item has been retitled to "Chat & Chatbots" to include a broader range of chat topics.

### 2021-07-15 {#2021-07-15}

[v5 Migration Guide](https://dev.twitch.tv/docs/api/migration) - Updated to include additional migration paths and indicated endpoints that are not supported beyond v5.

### 2021-07-13 {#2021-07-13}

[Using the Twitch API in an Extension Front End](https://dev.twitch.tv/docs/extensions/frontend-api-usage.md) - Added to describe how to a JWT can be used to make Twitch API requests from an Extension front end.

The following Extension-related Twitch API endpoints have been added:
- [Get Extension Configuration Segment](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extension-configuration-segment)
- [Set Extension Configuration Segment](https://dev.twitch.tv/docs/api/reference/extensions.md#set-extension-configuration-segment)
- [Set Extension Required Configuration](https://dev.twitch.tv/docs/api/reference/extensions.md#set-extension-required-configuration)
- [Send Extension PubSub Message](https://dev.twitch.tv/docs/api/reference/extensions.md#send-extension-pubsub-message)
- [Get Extension Live Channels](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extension-live-channels)
- [Get Extension Secrets](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extension-secrets)
- [Create Extension Secret](https://dev.twitch.tv/docs/api/reference/extensions.md#create-extension-secret)
- [Send Extension Chat Message](https://dev.twitch.tv/docs/api/reference/extensions.md#send-extension-chat-message)
- [Get Extensions](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extensions)
- [Get Released Extensions](https://dev.twitch.tv/docs/api/reference/extensions.md#get-released-extensions)
- [Get Extension Bits Products](https://dev.twitch.tv/docs/api/reference/extensions.md#get-extension-bits-products)
- [Update Extension Bits Product](https://dev.twitch.tv/docs/api/reference/extensions.md#update-extension-bits-product)

### 2021-07-02 {#2021-07-02}

[Twitch IRC: Tags](https://dev.twitch.tv/docs/irc/tags) - Minor updates, deprecated tags removed, and chat replies added.

### 2021-06-30 {#2021-06-30}

Enhanced Experiences and Event-based Drops are now generally available.

[Get Drops Entitlements](https://dev.twitch.tv/docs/api/reference/entitlements.md#get-drops-entitlements) - Updated to include `fulfillment_status`.

[Update Drops Entitlements](https://dev.twitch.tv/docs/api/reference/entitlements.md#update-drops-entitlements) - Added to the Twitch API reference.

[User Authorization Grant](https://dev.twitch.tv/docs/eventsub/reference/user.md#user-authorization-grant) EventSub subscription type added as v1.

[Drops](https://dev.twitch.tv/docs/drops.md) guide - Minor changes and updates regarding the additions above.

### 2021-06-25 {#2021-06-25}

[Drop Entitlement Grant](https://dev.twitch.tv/docs/eventsub/reference/drop.md#drop-entitlement-grant) EventSub subscription type added.

Update regarding the temporary pause of chatbot verification added to the [Twitch Chat Guide](https://dev.twitch.tv/docs/irc#verified-bots).

### 2021-06-17 {#2021-06-17}

[Get Channel Chat Badges](https://dev.twitch.tv/docs/api/reference/chat.md#get-channel-chat-badges) - Now supports OAuth app access tokens in addition to OAuth user access tokens.

EventSub - [Channel Subscription End Event](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-subscription-end) added `tier` and `is_gift`.

[Authentication](https://dev.twitch.tv/docs/authentication/scopes.md) - The existing `user:read:email ` scope has been added.

### 2021-06-15 {#2021-06-15}

Twitch API endpoints added for Twitch channel stream schedule.
- [Get Channel Stream Schedule](https://dev.twitch.tv/docs/api/reference/schedule.md#get-channel-stream-schedule)
- [Get Channel iCalendar](https://dev.twitch.tv/docs/api/reference/schedule.md#get-channel-icalendar)
- [Update Channel Stream Schedule](https://dev.twitch.tv/docs/api/reference/schedule.md#update-channel-stream-schedule)
- [Create Channel Stream Schedule Segment](https://dev.twitch.tv/docs/api/reference/schedule.md#create-channel-stream-schedule-segment)
- [Update Channel Stream Schedule Segment](https://dev.twitch.tv/docs/api/reference/schedule.md#update-channel-stream-schedule-segment)
- [Delete Channel Stream Schedule Segment](https://dev.twitch.tv/docs/api/reference/schedule.md#delete-channel-stream-schedule-segment)

[Channel Subscription Message](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-subscription-message) has moved from public beta to v1.

### 2021-06-11 {#2021-06-11}

[Channel Subscription Gift](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-subscription-gift) has moved from public beta to v1.

[Get Videos](https://dev.twitch.tv/docs/api/reference/videos.md#get-videos) updated to explicitly mention the 500 results limit when specifying `game_id`.

### 2021-06-08 {#2021-06-08}

Twitch API endpoints added for Twitch Emotes.
- [Get Channel Emotes](https://dev.twitch.tv/docs/api/reference/chat.md#get-channel-emotes)
- [Get Global Emotes](https://dev.twitch.tv/docs/api/reference/chat.md#get-global-emotes)
- [Get Emote Sets](https://dev.twitch.tv/docs/api/reference/chat.md#get-emote-sets)

### 2021-06-07 {#2021-06-07}

[Channel Subscription Message](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-subscription-message) EventSub subscription type added as a public beta.

[Extension Bits Transaction Create](https://dev.twitch.tv/docs/eventsub/reference/extension.md#extension-bits-transaction-create) EventSub subscription type has moved from public beta to version 1.

### 2021-06-03 {#2021-06-03}

Channel Subscription Gift EventSub subscription type - Added `is_anonymous` boolean to the event.

[AutoMod Queue](https://dev.twitch.tv/docs/pubsub#example-automod-queue-message) and [User Moderation Notifications](https://dev.twitch.tv/docs/pubsub#example-user-moderation-notification-message) PubSub topics - Examples updated for accuracy.

Several [GitHub Issues](https://github.com/twitchdev/issues/issues?q=is%3Aissue+is%3Aopen+label%3A%22product%3A+docs%22) resolved for documentation.

### 2021-06-02 {#2021-06-02}

[Get Broadcaster Subscriptions](https://dev.twitch.tv/docs/api/reference/subscriptions.md#get-broadcaster-subscriptions) - `total` subscription count added to the response.

### 2021-05-28 {#2021-05-28}

Twitch API endpoints have been added for chat badges.
- [Get Channel Chat Badges](https://dev.twitch.tv/docs/api/reference/chat.md#get-channel-chat-badges)
- [Get Global Chat Badges](https://dev.twitch.tv/docs/api/reference/chat.md#get-global-chat-badges)

EventSub subscription type updates.
- [Channel Subscription End](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-subscription-end) has moved from public beta to v1. This was previously known as "Channel Unsubscribe."
- [Channel Subscription Gift](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-subscription-gift) has been added as a public beta.

### 2021-05-24 {#2021-05-24}

[Polls](https://dev.twitch.tv/docs/api/reference/polls.md#get-polls) and [Channel Points Predictions](https://dev.twitch.tv/docs/api/reference/predictions.md#get-predictions) Twitch API endpoints have moved from public beta to general availability.

[Polls](https://dev.twitch.tv/docs/eventsub/reference/poll.md#channel-poll-begin) and [Channel Points Predictions](https://dev.twitch.tv/docs/eventsub/reference/prediction.md#channel-prediction-begin) EventSub subscription types have moved from public beta to version 1.

AutoMod Queue and User Moderation Notification topics added to [PubSub reference](https://dev.twitch.tv/docs/pubsub/).

### 2021-05-21 {#2021-05-21}

[Extension Bits Transaction Create](https://dev.twitch.tv/docs/eventsub/reference/extension.md#extension-bits-transaction-create) EventSub subscription type has been added as a public beta.

[Channel Points Custom Rewards](https://dev.twitch.tv/docs/api/reference/channel-points.md#create-custom-rewards) - The API reference for Custom Rewards endpoints has been updated for consistency and to clarify conditional requirements for body parameters. For example, `max_per_stream` is required if a value for `is_max_per_stream_enabled` is also provided.

### 2021-05-14 {#2021-05-14}

[Channel Prediction Lock](https://dev.twitch.tv/docs/eventsub/reference/prediction.md#channel-prediction-lock) EventSub subscription type - corrected the name of the lock timestamp to `locked_at`.

[Channel Prediction End](https://dev.twitch.tv/docs/eventsub/reference/prediction.md#channel-prediction-end) EventSub subscription type - removed the `locked_at` field due to edge cases with Predictions that are cancelled or closed early.

[Create EventSub Subscription](https://dev.twitch.tv/docs/api/reference/eventsub.md#create-eventsub-subscription) and [Get EventSub Subscriptions](https://dev.twitch.tv/docs/api/reference/eventsub.md#get-eventsub-subscriptions) - `limit` removed following the new [EventSub subscription limit cost-based system](https://discuss.dev.twitch.tv/t/eventsub-subscription-limit-cost-based-system-and-limit-field-deprecation/31377).

[Get Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#get-channel-information) - Added `delay` to return values table and example payload.

### 2021-05-12 {#2021-05-12}

[Manage Held AutoMod Messages](https://dev.twitch.tv/docs/api/reference/moderation.md#manage-held-automod-messages) – Added to the Twitch API reference.

[Authentication](https://dev.twitch.tv/docs/authentication/scopes.md) - `moderator:manage:automod` scope added for [Manage Held AutoMod Messages](https://dev.twitch.tv/docs/api/reference/moderation.md#manage-held-automod-messages).

### 2021-05-06 {#2021-05-06}

[Channel Subscription End](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-subscription-end) EventSub subscription type has been added as a public beta.

*This entry has been updated, the subscription type has been renamed from "Channel Unsubscribe" to "Channel Subscription End" after moving from beta to v1.*

### 2021-05-03 {#2021-05-03}

Twitch API endpoints added for polls and Channel Points Predictions as a public beta.

- [Get Polls](https://dev.twitch.tv/docs/api/reference/polls.md#get-polls)
- [Create Poll](https://dev.twitch.tv/docs/api/reference/polls.md#create-poll)
- [End Poll](https://dev.twitch.tv/docs/api/reference/polls.md#end-poll)
- [Get Predictions](https://dev.twitch.tv/docs/api/reference/predictions.md#get-predictions)
- [Create Prediction](https://dev.twitch.tv/docs/api/reference/predictions.md#create-prediction)
- [End Prediction](https://dev.twitch.tv/docs/api/reference/predictions.md#end-prediction)

EventSub subscriptions types added for polls and Channel Points Predictions as a public beta.

- [Channel Poll Begin](https://dev.twitch.tv/docs/eventsub/reference/poll.md#channel-poll-begin)
- [Channel Poll Progress](https://dev.twitch.tv/docs/eventsub/reference/poll.md#channel-poll-progress)
- [Channel Poll End](https://dev.twitch.tv/docs/eventsub/reference/poll.md#channel-poll-end)
- [Channel Prediction Begin](https://dev.twitch.tv/docs/eventsub/reference/prediction.md#channel-prediction-begin)
- [Channel Prediction Progress](https://dev.twitch.tv/docs/eventsub/reference/prediction.md#channel-prediction-progress)
- [Channel Prediction Lock](https://dev.twitch.tv/docs/eventsub/reference/prediction.md#channel-prediction-lock)
- [Channel Prediction End](https://dev.twitch.tv/docs/eventsub/reference/prediction.md#channel-prediction-end)

### 2021-04-30 {#2021-04-30}

[Overview page](https://dev.twitch.tv/docs/index.md) - New information and organization.

[EventSub Subscriptions Types](https://dev.twitch.tv/docs/eventsub/eventsub-subscription-types#public-beta-program) - Added information regarding the expected availability of EventSub subscription types when released as a public beta.

### 2021-04-26 {#2021-04-26}

[Notification Example](https://dev.twitch.tv/docs/eventsub/reference/user.md#user-authorization-revoke) for `user.authorization.revoke` updated to show the cost is 1.

[Embedding Twitch](https://dev.twitch.tv/docs/embed.md) - Minor documentation updates.

### 2021-04-20 {#2021-04-20}

[Get Followed Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-followed-streams) - Added to the Twitch API reference.

[Authentication](https://dev.twitch.tv/docs/authentication/scopes.md) - `user:read:follows` scope added for [Get Followed Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-followed-streams).

[v5 Migration Guide](https://dev.twitch.tv/docs/api/migration) - Updated to mention [Get Followed Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-followed-streams) equivalence.

### 2021-04-15 {#2021-04-15}

[Modify Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#modify-channel-information) – `delay` added as an optional body parameter.

New API response fields added
- [Get Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-streams): `is_mature`
- [Get Clips](https://dev.twitch.tv/docs/api/reference/clips.md#get-clips): `duration`
- [Search Channels](https://dev.twitch.tv/docs/api/reference/search.md#search-channels): `game_name`
- [Get Videos](https://dev.twitch.tv/docs/api/reference/videos.md#get-videos): `stream_id`
- [Get Videos](https://dev.twitch.tv/docs/api/reference/videos.md#get-videos): `muted_segments` array of objects with `duration` and `offset`

### 2021-04-09 {#2021-04-09}

[Get Broadcaster Subscriptions](https://dev.twitch.tv/docs/api/reference/subscriptions.md#get-broadcaster-subscriptions) - Added context for how a Twitch Extension can retrieve this information.

[Update User](https://dev.twitch.tv/docs/api/reference/users.md#update-user) - Clarifying why `description` is optional and what results if not provided.

Extensions Reference - Parameter tables reordered to match the order they should be passed into their respective functions.

Other minor corrections.

### 2021-04-05 {#2021-04-05}

Twitch Quarterly Insights has been decommissioned and removed in favor of [Game Developer Analytics](https://dev.twitch.tv/docs/insights.md#game-developer-analytics).

### 2021-03-31 {#2021-03-31}

Viewer Heartbeat Service (VHS) v5 endpoints removed in association with the decommission of legacy Drops.

### 2021-03-30 {#2021-03-30}

[Organizations](https://dev.twitch.tv/docs/companies.md) updated to include information regarding joining multiple organizations, as well as minor updates.

### 2021-03-26 {#2021-03-26}

EventSub's [Channel Moderator Add](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-moderator-add) and [Channel Moderator Remove](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-moderator-remove) subscriptions types have been moved from beta to v1.

Added associated Twitch API endpoints to the [scopes section](https://dev.twitch.tv/docs/authentication/scopes.md) of the Authentication guide.

Minor design improvements.

### 2021-03-19 {#2021-03-19}

[Get Drops Entitlements](https://dev.twitch.tv/docs/api/reference/entitlements.md#get-drops-entitlements)
- The maximum value for the number of items return via the `first` parameter has been increased to 1000.
- Pagination updated for accuracy in the the return values table and the example payload.

Webhooks example payloads updated for accuracy.

Miscellaneous corrections.

### 2021-03-12 {#2021-03-12}

Added [Check User Subscription](https://dev.twitch.tv/docs/api/reference/subscriptions.md#check-user-subscription) to the Twitch API.

EventSub's cost-based system for [subscription limits](https://dev.twitch.tv/docs/eventsub/manage-subscriptions.md#subscription-limits) has been added. Thanks for the feedback on [RFC 0014](https://discuss.dev.twitch.tv/t/rfc-0014-eventsub-subscription-limit-changes/30312/).

Improved the instructions and information regarding the creation of Twitch applications for [Drops campaigns](https://dev.twitch.tv/docs/drops.md).

Several documentation corrections received through GitHub Issues have been resolved.

### 2021-03-04 {#2021-03-04}

Twitch API
- [Get Channel Teams](https://dev.twitch.tv/docs/api/reference/teams.md#get-channel-teams) has been added to the API reference.
- [Get Teams](https://dev.twitch.tv/docs/api/reference/teams.md#get-teams) has been added to the API reference.
- The v5 migration guide has been updated to include the new Get Teams endpoint.

EventSub
- The [Channel Raid](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-raid) subscription type has been moved from beta to v1. 
- The [Channel Moderator Add](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-moderator-add) and [Channel Moderator Remove](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-moderator-remove) subscription types have been added as a public beta.

### 2021-02-26 {#2021-02-26}

EventSub updates
- Added clarification in steps 4-5 on "Create a subscription."
- [Channel Follow](https://dev.twitch.tv/docs/eventsub/reference/channel.md#channel-follow) now includes the timestamp of when the follow occurred.
- Clarified the `id` field in the [EventSub Stream Online](https://dev.twitch.tv/docs/eventsub/reference/stream.md#stream-online) notification payload.

The following endpoints were updated to use the `channel:manage:broadcast` scope. The previous scope remains valid.
- [Modify Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#modify-channel-information)
- [Create Stream Marker](https://dev.twitch.tv/docs/api/reference/streams.md#create-stream-marker)
- [Replace Stream Tags](https://dev.twitch.tv/docs/api/reference.md#replace-stream-tags)

Updated the v5 Video Upload Guide introduction for visitors looking for information regarding uploads via the Creator Dashboard.

Fixed broken links in [chat](https://dev.twitch.tv/docs/irc) references.

Removed the "Create Entitlement Grants Upload URL" Twitch API endpoint associated with a previous version of Twitch Drops.

### 2021-02-22 {#2021-02-22}

Legacy Drops have been removed following the [announced decommission](https://discuss.dev.twitch.tv/t/announcing-a-new-version-of-drops-for-game-developers/27771).

### 2021-02-19 {#2021-02-19}

`status` added to EventSub [subscription objects](https://dev.twitch.tv/docs/eventsub/reference.md).

Scope for [Channel Subscriptions](https://dev.twitch.tv/docs/pubsub#topics) in PubSub has been updated to `channel:read:subscriptions`. Previous scope remains valid.

[Channel Points Hackathon](https://twitchchannelpoints.devpost.com/?utm_source=twitch&utm_medium=docs) banner added.

Further clarification for `game_id` and `title` added for [Modify Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#modify-channel-information).

Minor updates to the [API guide](https://dev.twitch.tv/docs/api/guide.md) and [Chat guide](https://dev.twitch.tv/docs/irc).

### 2021-02-12 {#2021-02-12}

[EventSub Channel Ban](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-ban) v1 now includes moderator information, reason for ban, and timeout duration if the ban was a timeout.

[EventSub Channel Unban](https://dev.twitch.tv/docs/eventsub/reference/channel-moderation.md#channel-unban) v1 now includes moderator information.

Section 7.5 of the [Extensions Guidelines and Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md) has been removed following the [original announcement](https://discuss.dev.twitch.tv/t/extension-policy-update-moderation/30215).

### 2021-02-09 {#2021-02-09}

In EventSub, the authorization scopes allowed for all Channel Point subscription types have been updated to accept `channel:read:redemptions` or `channel:manage:redemptions`.

Updated [Get Users](https://dev.twitch.tv/docs/api/reference/users.md#get-users) to correctly document `created_at` in the example.

Minor editorial updates to the [Extensions Monetization Guide](https://dev.twitch.tv/docs/extensions/monetization.md).

### 2021-02-05 {#2021-02-05}

Eventsub API endpoints have been moved to the [API reference](https://dev.twitch.tv/docs/api/reference.md).

A message regarding the deprecation of Twitch Quarterly Insights has been added to [Insights](https://dev.twitch.tv/docs/insights.md) following the recent [announcement](https://discuss.dev.twitch.tv/t/deprecation-of-the-quarterly-insights-report/30266/2){:
      target="_blank"}.

Explicitly stating in [Extensions](https://dev.twitch.tv/docs/extensions.md) that files should be zipped together as opposed to zipping the directory containing the files.

Miscellaneous UserVoice and GitHub Issues addressed.

### 2021-01-29 {#2021-01-29}

EventSub
- The Channel Raid subscription type has been added as a public beta.
- The `started_at` timestamp has been added to the [Stream Online Event](https://dev.twitch.tv/docs/eventsub/reference/stream.md#stream-online).

A note about removing [Extensions Policy 7.5](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md) has been added since Twitch Extensions no longer load for banned users.

The [Drops guide](https://dev.twitch.tv/docs/drops.md) now includes a section regarding thoughtful naming of campaigns and rewards.

[Product Lifecycle](https://dev.twitch.tv/docs/product-lifecycle) has been updated to include definitions for tagging functionality in the documentation.

### 2021-01-28 {#2021-01-28}

`broadcaster_login` and/or `user_login` added to multiple API endpoint payloads that already return user ID and display name.

- [GET helix/bits/leaderboard](https://dev.twitch.tv/docs/api/reference/bits.md#get-bits-leaderboard)
- [GET helix/channel_points/custom_rewards](https://dev.twitch.tv/docs/api/reference/channel-points.md#get-custom-reward)
- [PATCH helix/channel_points/custom_rewards](https://dev.twitch.tv/docs/api/reference/channel-points.md#update-custom-reward)
- [POST helix/channel_points/custom_rewards](https://dev.twitch.tv/docs/api/reference/channel-points.md#create-custom-rewards)
- [GET helix/channel_points/custom_rewards/redemptions](https://dev.twitch.tv/docs/api/reference/channel-points.md#get-custom-reward-redemption)
- [PATCH helix/channel_points/custom_rewards/redemptions](https://dev.twitch.tv/docs/api/reference/channel-points.md#update-redemption-status)
- [GET helix/extensions/transactions](https://dev.twitch.tv/docs/api/reference/bits.md#get-extension-transactions)
- [GET helix/moderation/banned](https://dev.twitch.tv/docs/api/reference/moderation.md#get-banned-users)
- GET helix/moderation/banned/events
- [GET helix/moderation/moderators](https://dev.twitch.tv/docs/api/reference/moderation.md#get-moderators)
- GET helix/moderation/moderators/events
- [GET helix/search/channels](https://dev.twitch.tv/docs/api/reference/search.md#search-channels)
- [GET helix/streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-streams)
- [GET helix/streams/markers](https://dev.twitch.tv/docs/api/reference/streams.md#get-stream-markers)
- [GET helix/videos](https://dev.twitch.tv/docs/api/reference/videos.md#get-videos)
- [GET helix/users/follows](https://dev.twitch.tv/docs/api/reference.md#get-users-follows)

### 2021-01-22 {#2021-01-22}

EventSub:
- Corrected `status` value in examples.
- Clarified requirements for `secret`.

[Authentication](https://dev.twitch.tv/docs/authentication.md) updates:
- Correctly state a `400 Bad Request` is returned when attempting to revoke an invalid token, rather than a `200 OK`.
- Scope information corrections and updates.

Additional updates:
- `offset` removed from Get Channel Followers endpoint in v5 as it is no longer supported. `cursor` should be used for pagination.
- Extensions tutorial updated to use Gists instead of image.
- Several UserVoice suggestions and GitHub Issues addressed.

### 2021-01-15 {#2021-01-15}

New Twitch API endpoints available:
- [Get Channel Editors](https://dev.twitch.tv/docs/api/reference/channels.md#get-channel-editors)
- [Delete Videos](https://dev.twitch.tv/docs/api/reference/videos.md#delete-videos)
- [Get User Block List](https://dev.twitch.tv/docs/api/reference/users.md#get-user-block-list)
- [Block User](https://dev.twitch.tv/docs/api/reference/users.md#block-user)
- [Unblock User](https://dev.twitch.tv/docs/api/reference/users.md#unblock-user)

The new scopes for these endpoints have also been added to [Authentication](https://dev.twitch.tv/docs/authentication/scopes.md). Updated the descriptions of existing scopes for consistency and accuracy.
- `channel:read:editors`
- `channel:manage:videos`
- `user:read:blocked_users`
- `user:manage:blocked_users`

[v5 migration guide](https://dev.twitch.tv/docs/api/migration) updates:
- New v5 scope mappings have been added for the above endpoints. See `channel_editor`, `channel_read`, `user_blocks_read`, and `user_blocks_edit`.
- Five endpoint equivalence definitions have been added for the above endpoints.

`giantbomb_id` set to 0 in the v5 Get Top Games response example to reflect a [game data migration](https://discuss.dev.twitch.tv/t/legacy-endpoints-returning-0-for-giantbomb-id-following-igdb-migration/29125).

### 2021-01-08 {#2021-01-08}

EventSub updates:
- Added support for filtering by `type`.
- Added user login to notification payloads.

Added `twitch://broadcast` mobile deeplink to broadcast a specific category.

Embed updates:
-  `enableCaptions()` function, `disableCaptions()` function, and `Twitch.Player.CAPTIONS` event added. 
- `sandbox` added for embedded chat.
-  `getPlaybackStats()` function and a description of the `PlaybackStats` object added back into the documentation.
-  `autoplay` documentation updated to note the default value is `false`.
- Removed `frameborder` and `scrolling` from Twitch embed examples as these were deprecated in HTML5.

Feedback and bug reports:
- [Bring back a function similar to .getPlaybackStats()](https://twitch.uservoice.com/forums/310213-developers/suggestions/39162130-bring-back-a-function-similar-to-getplaybackstats)
- [Channel Update Notification Example Contradicts Channel Update Event Documentation](https://github.com/twitchdev/issues/issues/268)
- [Typo in "Chatbots & IRC Guide" section](https://github.com/twitchdev/issues/issues/281) and [typo](https://twitch.uservoice.com/forums/310213/suggestions/42309586)
- [Google Analytics in extensions: example not up to date with GA changes](https://github.com/twitchdev/issues/issues/277)
- [Typo in EventSub Guide page](https://twitch.uservoice.com/forums/310213/suggestions/42381577)
- [Unclear Mention of Regex for Bits Parameter](https://twitch.uservoice.com/forums/310213/suggestions/42301396)
- [[TYPO] EventSub channel.update docs](https://twitch.uservoice.com/forums/310213/suggestions/42230230)
- [Deprecated attribute](https://twitch.uservoice.com/forums/310213/suggestions/40632823)

## 2020

### 2020-12-18 {#2020-12-18}

Updated auth validation sample with values and the `expires_in` field.

[Updated JavaScript helper examples](https://twitch.uservoice.com/forums/310213/suggestions/41541955) to use  `window.Twitch.ext`.

Clarifcation for linking accounts for time-based Drops.

Miscellaneous API reference fixes.

### 2020-12-17 {#2020-12-17}

Details for retriving ingest servers have been moved to the top-level [Video Broadcasting](https://dev.twitch.tv/docs/video-broadcast.md) section. This includes the launch of "[Get Ingest Servers](https://dev.twitch.tv/docs/video-broadcast/reference.md#get-ingest-servers)" to replace its deprecated version previously found in v5.

### 2020-12-04 {#2020-12-04}

UserVoice feedback fixes:
- [Further documenting endpoints that support `first` and `after`](https://twitch.uservoice.com/forums/310213-developers/suggestions/39847735-docs-missing-first-pagination-on-api-s-that-suppor)
- ["Get Users" now mentions an app access token can be used](https://twitch.uservoice.com/forums/310213-developers/suggestions/40479460-get-users-doesn-t-mention-that-an-app-access-token)
- [`user:read:email` corrected to be optional](https://twitch.uservoice.com/forums/310213-developers/suggestions/40803598-helix-users-docs-showing-optional-scope-as-require)
- [`broadcaster_name` documented for "Get Channel Information"](https://twitch.uservoice.com/forums/310213-developers/suggestions/41036398-broadcaster-name-not-noted-in-return-values-of-get)
- [Backend typo](https://twitch.uservoice.com/forums/310213-developers/suggestions/41954035-typo)
- [Subscriptions webhook link fixed](https://twitch.uservoice.com/forums/310213-developers/suggestions/41904073-broken-link)
- [`usage_untimeout` correction](https://twitch.uservoice.com/forums/310213-developers/suggestions/41774833-fix-usage-untimeout-documentation-note)
- [OAuth procedure links are clickable](https://twitch.uservoice.com/forums/310213/suggestions/40366696)
- [Possible typo for separating scopes](https://twitch.uservoice.com/forums/310213-developers/suggestions/42060712-possible-error-typo)
- [Fixed example payload for Get All Chat Emoticons](https://twitch.uservoice.com/forums/310213/suggestions/39847549)
- [Added clarification for expected language query parameters and response values](https://twitch.uservoice.com/forums/310213/suggestions/39848104)
- [Fixed link to configuration service reference](https://twitch.uservoice.com/forums/310213/suggestions/39848128)

Miscellaneous fixes:
- Removed duplicate search results
- Displaying more search results
- Provided the full accept header in the v5 "Requests" section
- Changed the date format in the changelog to YYYY-MM-DD

### 2020-12-01 {#2020-12-01}

Added `progress` field to Hype Train [EventSub subscription types](https://dev.twitch.tv/docs/eventsub/reference.md).

### 2020-11-30 {#2020-11-30}

Corrections and edits to the [EventSub](https://dev.twitch.tv/docs/eventsub.md) documentation.
Fixed a typo for "msg-param-gift-months" under [IRC usernotices](https://dev.twitch.tv/docs/irc/tags#usernotice-tags).

### 2020-11-19 {#2020-11-19}

Corrections and edits to the [EventSub](https://dev.twitch.tv/docs/eventsub.md) documentation.

Updated [Drops Analytics](https://dev.twitch.tv/docs/insights.md#drops-analytics-beta) image.

Changed type for `pagination` [response field](https://dev.twitch.tv/docs/api/reference.md) to be "object containing a string".

Corrections and edits to [scopes](https://dev.twitch.tv/docs/authentication.md#scopes) documentation.

### 2020-11-13 {#2020-11-13}

Added documentation for [EventSub](https://dev.twitch.tv/docs/eventsub.md).

Added Channel Points API to the [API Reference](https://dev.twitch.tv/docs/api/reference.md).

Added a v5 to Twitch API [migration guide](https://dev.twitch.tv/docs/api/migration).

### 2020-11-04 {#2020-11-04}

Added information about [Drops Analytics](https://dev.twitch.tv/insights/#drops-analytics-beta) to documentation.

### 2020-10-29 {#2020-10-29}

Removed CurseForge references from docs.

API Reference:

* Corrected token requirement for [Get Stream Tags](https://dev.twitch.tv/docs/api/reference/tags#get-stream-tags).
* Made sub-section ordering consistent, listing query parameters before body parameters.
* Corrected [Modify Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#modify-channel-information) documentation which had body parameters listed as query parameters.

Pub Sub:

* Updated user notices for multi-month subscriptions.
* Added sample code for multi-month subscriptions.
* Updated the topic for [chat moderator actions](https://dev.twitch.tv/docs/pubsub#topics).

### 2020-10-26 {#2020-10-26}

[API Reference](https://dev.twitch.tv/docs/api/reference.md)

* Fixed issue causing apostrophes to show as random characters.
* Removed duplicate entry for Get Stream Tags.

[Authentication Guide](https://dev.twitch.tv/docs/authentication.md)

* Added maximum OAuth token limits.
* Added `channel:read:redemptions` scope.
* Corrected the spelling of `channel:manage:broadcast`.

Clarified instructions for supplying parameters in the Webhooks Reference.

Clarified limits in the Webhooks Guide.

In the [Extensions Guide](https://dev.twitch.tv/docs/extensions.md), corrected the environment variable `HTTPS=true` for create-react-app.

### 2020-10-09 {#2020-10-09}

Updates to the [API Reference](https://dev.twitch.tv/docs/api/reference.md)

* Made example code consistent.
* Eliminated duplicate entry for the Get Stream Tags endpoint.
* Fixed typos.

Fixed a typo in the [channel:manage:broadcast](https://dev.twitch.tv/docs/authentication.md#scopes) scope.

Removed the Glossary.

### 2020-09-23 {#2020-09-23}

Removed links to internal documents in [Increase Feedback in Extensions](https://dev.twitch.tv/docs/extensions/increasing-feedback.md).

### 2020-09-17 {#2020-09-17}

Added to the v5 API Get Channel Subscribers endpoint the information that if a user in the subscribers list has been banned, the subscription information will be provided, but the user object will have a value of `null`.

### 2020-09-15 {#2020-09-15}

Edited all documentation to replace the terms "blacklist" and "whitelist" with "denylist" and "allowlist".

Edited and redesigned the top-level page:

* Fixed broken links.
* Added links to UserVoice and GitHub for feedback and support.
* Removed outdated screenshots.
* Removed redundant links.

Added to the [Get Clips](https://dev.twitch.tv/docs/api/reference/clips.md#create-clip) endpoint documentation that clips are returned sorted by view count, in descending order.

### 2020-09-14 {#2020-09-14}

Updated the following endpoints to make clear they are about Bits codes:

* [Get Code Status](https://dev.twitch.tv/docs/api/reference.md#get-code-status)
* [Redeem Code](https://dev.twitch.tv/docs/api/reference.md#redeem-code)

Updated Extensions documentation to say that layout needs to accommodate variable height rather than fixed at 700 pixels.

### 2020-09-12 {#2020-09-12}

Added discussion of subscription status support to the [Extensions Monetization](https://dev.twitch.tv/docs/extensions/monetization.md) documentation.

Clarified language in the [Create Clip](https://dev.twitch.tv/docs/api/reference/clips.md#create-clip) endpoint documentation.

### 2020-09-07 {#2020-09-07}

Documented [authentication](https://dev.twitch.tv/docs/irc/authenticate-bot) and [Join rate limits](https://dev.twitch.tv/docs/irc#rate-limits) for [chat](https://dev.twitch.tv/docs/irc).

Removed documentation for chat rooms, because the feature is deprecated.

### 2020-08-28 {#2020-08-28}

Removed mention of a webhook for Drops because it is not yet available.

### 2020-08-25 {#2020-08-25}

Updated the [API Reference](https://dev.twitch.tv/docs/api/reference/clips.md#create-clip) to note that the clips service returns a maximum of 1000 clips.

Removed the deprecated information about rate limits when there is no token from the [API Guide](https://dev.twitch.tv/docs/api/guide.md).

Added pagination information to the [Get Drops Entitlements](https://dev.twitch.tv/docs/api/reference/entitlements.md#get-drops-entitlements) endpoint documentation.

### 2020-08-21 {#2020-08-21}

Fixed code sample for Events-based Drops.

### 2020-08-20 {#2020-08-20}

Updated Authorization section for the [Get Clips](https://dev.twitch.tv/docs/api/reference/clips.md#create-clip) endpoint to indicate that a user access token is required.

### 2020-08-18 {#2020-08-18}

* Published [Drops 2.0](https://dev.twitch.tv/docs/drops.md) documentation
* added `Get Drops Entitlements` to the [API reference](https://dev.twitch.tv/docs/api/reference.md)

### 2020-08-13 {#2020-08-13}

Added a new section to our Extension Submission Best Practices: [*Template for a helpful Walkthrough Guide and Change Log*](https://dev.twitch.tv/docs/extensions/submission-best-practices.md#template-for-a-helpful-walkthrough-guide-and-change-log)

### 2020-07-30 {#2020-07-30}

Updated Marketing and Developer [User Roles](https://dev.twitch.tv/docs/companies.md#user-roles).

Updated Webhooks documentation to describe notification timeout.

Changed documentation of [Start Commercial](https://dev.twitch.tv/docs/api/reference/ads.md#start-commercial) response field from retryAfter to retry\_after.

### 2020-07-23 {#2020-07-23}

Updated Extensions documentation to reflect new process for required review channels.

### 2020-07-21 {#2020-07-21}

Addressed issues in the API reference for the following endpoints:

* [Get Stream Key](https://dev.twitch.tv/docs/api/reference/streams.md#get-stream-key)
* [Get Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#get-channel-information)
* [Modify Channel Information](https://dev.twitch.tv/docs/api/reference/channels.md#modify-channel-information)
* [Delete User Follows](https://dev.twitch.tv/docs/api/reference.md#delete-user-follows)
* [Get Hype Train Events](https://dev.twitch.tv/docs/api/reference.md#get-hype-train-events)

### 2020-07-06 {#2020-07-06}

Added required authorization for the [Get Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-streams) endpoint and updated sample code.

### 2020-07-01 {#2020-07-01}

Added new fields to the [Channel Subscriptions Event Pubsub topic](https://dev.twitch.tv/docs/pubsub/#example-channel-subscriptions-event-message) and a new [USERNOTICE tag parameter](https://dev.twitch.tv/docs/irc/tags#usernotice-tags) in support of Multi-Month Subscription Gifting.

### 2020-06-22 {#2020-06-22}

Updated the [Authentication Guide](https://dev.twitch.tv/docs/authentication.md) to mention that developers can provide multiple redirect URIs.

Bug fixes in the [API Reference](https://dev.twitch.tv/docs/api/reference.md).

### 2020-06-18 {#2020-06-18}

Added new endpoints to the [API Reference](https://dev.twitch.tv/docs/api/reference.md) and Webhooks Reference:

* Get Channel Information
* Modify Channel Information
* Search Channels
* Search Categories
* Get Stream Key
* Start Commercial
* Create User Follows
* Delete User Follows
* Get Cheermotes

Added new functionality to the API: the [Hype Train API](https://dev.twitch.tv/docs/api/reference.md#get-hype-train-events).

### 2020-06-15 {#2020-06-15}

Added links to [rate limits documentation](https://dev.twitch.tv/docs/api/guide.md#rate-limits) to the API Reference.

### 2020-06-03 {#2020-06-03}

Clarified the definition of Subscription denied in the Webhooks Guide.

### 2020-05-12 {#2020-05-12}

Removed documentation of MODE and NAMES in the [IRC documentation](https://dev.twitch.tv/docs/irc/membership) because they have not functioned correctly for some time and will not be supported.

### 2020-05-08 {#2020-05-08}

[Drops Guide](https://dev.twitch.tv/docs/drops.md) Updated [Create Entitlement Grants Upload URL](https://dev.twitch.tv/docs/api/reference.md#create-entitlement-grants-upload-url) example to include Client ID.

[API Reference](https://dev.twitch.tv/docs/api/reference.md) Updated all example requests to include Client ID and token in Authorization header, as per new OAuth requirement.

### 2020-05-04 {#2020-05-04}

Fixed a bug in the API Reference. The optional scope for the [Get Users](https://dev.twitch.tv/docs/api/reference/users.md#get-users) endpoint should be `user:read:email`.

### 2020-05-01 {#2020-05-01}

Updated the [Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md) to reflect that OAuth is now mandated.

Updated the [Authentication Guide](https://dev.twitch.tv/docs/authentication.md) to include new OAuth scopes. 

Updated the Webhooks Reference to show that authorization is now required authorization for every web hook.

### 2020-04-27 {#2020-04-27}

Updated Extensions Best Practices: 

* [Commerce Best Practices](https://dev.twitch.tv/docs/extensions/submission-best-practices.md#commerce-in-extensions) 
* [Bits Best Practices](https://dev.twitch.tv/docs/extensions/submission-best-practices.md#bits-in-extensions)

Updated the [Extensions Guidelines and Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md) page for Content and Commerce.

### 2020-04-20 {#2020-04-20}

Updated [Drops](https://dev.twitch.tv/docs/drops.md) documentation to align with UI changes.

### 2020-04-01 {#2020-04-01}

Deleted documentation of these deprecated v5 endpoints:

* Get Channel Communities
* Set Channel Communities
* Delete Channel from Communities

Corrected URL for [Get Extension Transaction](https://dev.twitch.tv/docs/api/reference/bits.md#get-extension-transactions) endpoint.

### 2020-03-30 {#2020-03-30}

Updated definition of "language" in v5 Streams API Reference.

### 2020-03-27 {#2020-03-27}

Published new [Extensions Guide](https://dev.twitch.tv/docs/extensions.md).

### 2020-03-18 {#2020-03-18}

Updates to the [Embedding Twitch](https://dev.twitch.tv/docs/embed.md) documentation: 

* Added new `parent` parameter.
* Removed deprecated `getPlaybackStats` method.
* Removed references to the `font-size` option for everywhere embeds.

### 2020-03-10 {#2020-03-10}

Updated the Extensions [Guidelines & Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md) to add Moderation.

### 2020-02-25 {#2020-02-25}

Edited the following endpoints in the v. 5 API Reference:

* v5 Get Live Streams
  * Removed `_total` field
  * Documented that the offset is capped at 900
* v5 Get Followed Streams
  * Removed `_total` field
  * Documented that the offset is capped at 900

Edited the [Get Game Analytics](https://dev.twitch.tv/docs/api/reference/analytics.md#get-game-analytics) endpoint to note that we only return data for the previous 365 days.

Updated documentation for the sunset of Premieres.

### 2020-02-14 {#2020-02-14}

Updated the `game_id` parameter in the [Get Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-streams) endpoint from up to 100 IDs to up to 10 IDs.

Documented the `isBitsEnabled` feature flag in the Extensions Reference.

Removed the link to the deprecated form to increase webhook subscription limits.

Added `gifter_id` and `gifter_name` fields to the Get Broadcaster Subscriptions [endpoint](https://dev.twitch.tv/docs/api/reference/subscriptions.md#get-broadcaster-subscriptions) and webhook.

### 2020-02-13 {#2020-02-13}

* Removed the `live` query string parameter from the Search Games v5 endpoint documentation.
* Removed the `popularity` response field from the Search Games v5 endpoint and the Get Top Games v5 endpoint documentation.

### 2020-01-24 {#2020-01-24}

Updates to PubSub [documentation](https://dev.twitch.tv/docs/pubsub/#topics) 

* Added Chat feature
* Added Required Scope for `channel-bits-events-v1` and `channel-bits-badge-unlocks`
* Removed `channel-commerce-events-v1` because it is deprecated

### 2020-01-10 {#2020-01-10}

* Updated documentation to reflect that OAuth is the preferred method of authentication.
* Removed documentation for chat rooms because the feature is deprecated.

### 2020-01-08 {#2020-01-08}

Extensions tutorials are now live on the site.

## 2019

### 2019-12-17 {#2019-12-17}

**Webhooks Reference**

* Updated description of Subscribe / Unsubscribe call to be more accurate about response codes and authentication required.
* Small syntax / formatting tweaks in the JSON examples.
* Mention the authenticated scopes needed for various authenticated webhooks.

**Webhooks Guide**

* Clarified how retries are performed and how we handle non-2xx response codes from clients.
* Provided insight into the implementation of a handler for verification according to the W3C websub spec.

### 2019-12-16 {#2019-12-16}

Added the [Channel Points](https://dev.twitch.tv/docs/pubsub#topics) PubSub topic.

### 2019-12-05 {#2019-12-05}

Added chat rooms to the [Product Lifecycle](https://dev.twitch.tv/docs/product-lifecycle) page as deprecated.

### 2019-12-02 {#2019-12-02}

Updated the [Getting Tokens OIDC](https://dev.twitch.tv/docs/authentication/getting-tokens-oidc.md) doc to note that the `email` and `email_verified` claims will soon be gated by `user:read:email` scope.

### 2019-10-22 {#2019-10-22}

Updated review section in [Extensions Life Cycle Management](https://dev.twitch.tv/docs/extensions/life-cycle.md) doc to include review SLA.

### 2019-10-16 {#2019-10-16}

Added Product Lifecycle page to the site.

### 2019-09-28 {#2019-09-28}

Added links to the Developer Rig in these pages: 

* [/extensions/\#hello-world](https://dev.twitch.tv/docs/extensions.md#hello-world)
* [/extensions/rig/](https://dev.twitch.tv/docs/extensions/rig/)

### 2019-09-11 {#2019-09-11}

Added [Increasing Feedback in Extensions](https://dev.twitch.tv/docs/extensions/increasing-feedback.md).

### 2019-09-10 {#2019-09-10}

Removed communities-related data fields from [Get Streams](https://dev.twitch.tv/docs/api/reference/streams.md#get-streams) and Get Streams Metadata endpoints. These fields are no longer supported.

Merged Get Broadcaster's Subscribers into [Get Broadcaster Subscriptions](https://dev.twitch.tv/docs/api/reference/subscriptions.md#get-broadcaster-subscriptions) because they both return the subscribers to a channel. 

Added [Load Testing Extensions Using Locust and Elastic Beanstalk](https://dev.twitch.tv/docs/extensions/load-testing-extensions.md) document.

Added [Submission Best Practices](https://dev.twitch.tv/docs/extensions/submission-best-practices.md) for Extensions.

### 2019-09-06 {#2019-09-06}

Corrected `msg_id` parameter type in Check AutoMod Status from integer to string.

### 2019-09-04 {#2019-09-04}

Added an updated Glossary.

### 2019-08-22 {#2019-08-22}

Edited the payload example in Topic: Subscription Events.

### 2019-08-14 {#2019-08-14}

Edited optional Create Stream Marker parameter *[description](https://dev.twitch.tv/docs/api/reference/streams.md#create-stream-marker)* to include a max length of 140 characters.

Removed "Increasing Feedback in Extensions".

### 2019-08-07 {#2019-08-07}

Update Mobile Deep Links

### 2019-08-05 {#2019-08-05}

Updated Organizations (formerly "Companies").

Updated Extensions: Developer Rig

Updated Extensions: Increasing Feedback in Your Extension.

### 2019-08-04 {#2019-08-04}

Add RBAC info to "Companies" (now "Organizations")

### 2019-07-31 {#2019-07-31}

Added 2.10 and 2.11 to Extensions Guidelines and Policies.

Updates to "Extensions: Designing" guide.

### 2019-07-30 {#2019-07-30}

Add RBAC information to Extensions Life Cycle Management and Monetization.

### 2019-07-29 {#2019-07-29}

Corrected URL for endpoint "Get Moderator Events".

### 2019-07-22 {#2019-07-22}

Extensions update - reset file ordering

### 2019-07-19 {#2019-07-19}

Retry adding 3 new Extensions docs (A/B Testing, Google Analytics, & Increasing Feedback)

### 2019-07-18 {#2019-07-18}

DA-430: Add three new Extensions documents: Using A/B Testing in Extensions, Using Google Analytics in Extensions, and Increasing Feedback in Extensions. Also made minor change in Drops (meaning of "retries").

### 2019-07-09 {#2019-07-09}

Updated "Chatbots & IRC" docs (Getting Started, Guide, Membership, Commands, Tags, & Chat Rooms), except for "msg-ID Tags".

Updated all "Embed" docs (Introduction, Embed Chat, Embed Video & Clips, & Embed Everything).

### 2019-06-27 {#2019-06-27}

Added documentation for Get Subscription Events [endpoint](https://dev.twitch.tv/docs/api/reference.md).

Added documentation for Subscription Events webhook.

### 2019-06-25 {#2019-06-25}

Documented the new [Moderation API](https://dev.twitch.tv/docs/api/reference.md).

Documented two new webhooks:

* Moderator Change Events
* Channel Ban Change Events

### 2019-06-21 {#2019-06-21}

Insights & Analytics updates (twice today)

### 2019-06-20 {#2019-06-20}

Changed "position" to "policies" in Extensions: Guidelines and Policies, section 6.6.

### 2019-06-19 {#2019-06-19}

Added clarification to the [Get Users](https://dev.twitch.tv/docs/api/reference/users.md#get-users) endpoint in the Twitch API Reference that the limit of 100 IDs and login names is a total limit, not 100 of each.

Changes to Helper Bits in the Extensions Reference:

* The field should be "`exp`" rather than "`expires`".
* Documented the `domainID` object.
* Edited definition of the `product` object.

### 2019-06-13 {#2019-06-13}

[Extensions Life Cycle Management](https://dev.twitch.tv/docs/extensions/life-cycle.md) Added section on Control Security Policy (CSP)

### 2019-06-07 {#2019-06-07}

Removed deprecated Channel Feed API Reference.

### 2019-06-06 {#2019-06-06}

[Extensions Guidelines & Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md)

* Added policy 6.2.8.

### 2019-06-04 {#2019-06-04}

Added Get Extension Transactions to the [Twitch API Reference](https://dev.twitch.tv/docs/api.md).

Added Extension Transaction Created to the Webhooks Reference.

### 2019-05-30 {#2019-05-30}

Updated v5 API Guide: New third-party development will be limited to the API versions Kraken v5 and Helix. Limitation of new development will be enforced on client ID created on or after 5/31/2019.

### 2019-05-08 {#2019-05-08}

Removed orphan Bits Code Redemption Guide and added the content to the [API Reference](https://dev.twitch.tv/docs/api/reference.md#redeem-code).

Fixed date errors in the [changelog](https://dev.twitch.tv/docs/change-log.md).

### 2019-05-07 {#2019-05-07}

Fixed code formatting errors in several endpoints.

Updated Configuration Service documentation.

Removed Topic: Extension Analytics and Topic: Game Analytics from the Webhooks Reference because the endpoint is returning invalid data.

### 2019-04-19 {#2019-04-19}

Removed note that Webhooks parameters must appear in alphabetical order because that restriction no longer exists.

[Extensions Guidelines & Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md)

* Added policies 1.5, 3.4, and 4.6.2.
* Appended 4.3 to mention Emotes usage and beta program.
* Appended 4.4 to mention advertising beta program.
* Removed 4.6.1 (Off-site links must be related to the extension's core functionality).
* Removed 4.6.3 (Off-site links must be included within your URL allowlist).
* Previous 5.2 and 5.3 reworked and appended to mention the commerce beta program.

### 2019-04-18 {#2019-04-18}

Updated link to download the Developer Rig for Windows.

Updated the v5 API Reference to indicate that the version is deprecated.

### 2019-04-16 {#2019-04-16}

Deleted Communities Reference from v5 API because it is deprecated.

### 2019-04-15 {#2019-04-15}

Video: Updated v5 Video Upload Guide and v5 Video Reference to note that you must be a Partner or Affiliate to upload VODs.

### 2019-03-27 {#2019-03-27}

[Chatbots & IRC: Twitch Tags](https://dev.twitch.tv/docs/irc/tags/): Added note that undocumented tags can be added/removed at any time. Also, tags may appear in any order. So, developers should write code to parse tags individually and ignore unrecognized tags.

### 2019-03-26 {#2019-03-26}

[Chatbots & IRC: Twitch Tags](https://dev.twitch.tv/docs/irc/tags/): Added new `badge-info` parameter to GLOBALUSERSTATE, PRIVMSG, USERNOTICE, and USERSTATE.

### 2019-03-18 {#2019-03-18}

[Getting Started with Extensions](https://dev.twitch.tv/docs/extensions.md) and [Extensions Developer Rig](https://dev.twitch.tv/docs/extensions/rig/): Changes based on the new Developer Rig UI. Updated “Hello World” example in _Getting Started_.

### 2019-03-15 {#2019-03-15}

Extensions Reference: Added information related to Monetization.

[Extensions Monetization Guide](https://dev.twitch.tv/docs/extensions/monetization.md) (formerly Bits in Extensions), [Extensions Life Cycle Management](https://dev.twitch.tv/docs/extensions/life-cycle.md): Added Monetization tab to Extensions manager, for selecting Bits support and/or new subscription status support, and for going to the monetization onboarding process.

### 2019-03-14 {#2019-03-14}

Websub: Updated documentation to make it clear that the order of query parameters matters.

[Bits](https://dev.twitch.tv/docs/extensions/monetization.md): Small edits to documentation, for clarity.

### 2019-03-11 {#2019-03-11}

[Chatbots & IRC: Twitch Tags](https://dev.twitch.tv/docs/irc/tags/): Added several more `msg-param` parameters (for USERNOTICE).

### 2019-03-08 {#2019-03-08}

[Chatbots & IRC: Twitch Tags](https://dev.twitch.tv/docs/irc/tags/): Deleted `broadcaster-lang` (from ROOMSTATE). Added several more valid values for the `msg-id` field (for USERNOTICE).

### 2019-03-07 {#2019-03-07}

[Extensions doc set](https://dev.twitch.tv/docs/extensions.md): Many changes. New version of _Getting Started with Extensions_. New Extensions manager UI (see _Extensions Life Cycle Management_).

### 2019-02-21 {#2019-02-21}

Insights & Analytics: Added mod author analytics.

### 2019-02-08 {#2019-02-08}

[PubSub](https://dev.twitch.tv/docs/pubsub/#topics): Added topic `channel-bits-events-v2`. Removed deprecated `months` field. Added new `cumulative-months` and `streak-months` fields.

### 2019-02-04 {#2019-02-04}

[Chatbots & IRC: Twitch Tags](https://dev.twitch.tv/docs/irc/tags/): For [USERNOTICE](https://dev.twitch.tv/docs/irc/tags#usernotice-tags), added three fields (`msg-param-cumulative-months`, `msg-param-should-share-streak`, `msg-param-streak-months`) and changed when `msg-param-months` is sent.

### 2019-01-30 {#2019-01-30}

[Apps & Authentication](https://dev.twitch.tv/docs/authentication/scopes.md): Added the scope `channel:read:subscriptions`.

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md): Added new endpoints: Get Broadcaster Subscriptions and Get User Subscriptions.

### 2019-01-28 {#2019-01-28}

[Apps & Authentication](https://dev.twitch.tv/docs/authentication.md): Clarified language around deprecation of Twitch API v. 5.

[Getting Started with Extensions](https://dev.twitch.tv/docs/extensions.md): Clarified using the native Developer Rig (beta).

### 2019-01-22 {#2019-01-22}

Extensions Reference: Added `locale` parameter to "Client Query Parameters."

### 2019-01-18 {#2019-01-18}

[Extensions Developer Rig](https://dev.twitch.tv/docs/extensions/rig/): Added section on “Enabling 2FA.”

### 2019-01-17 {#2019-01-17}

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md): Added new endpoints: Replace Stream Tags, Get Stream Tags, and Get All Stream Tags. Updated Get Streams endpoint to document new tags functionality.

[Mobile Deep Links](https://dev.twitch.tv/docs/mobile-deeplinks.md#deep-link-formats): Added deep links for category tags and live-stream tags.

[Insights & Analytics](https://dev.twitch.tv/docs/insights.md): Several clarifications, based on user feedback. Revised definitions of data fields that use device IDs. New section on “Counting Device IDs.”

## 2018

### 2018-12-21 {#2018-12-21}

[Getting Started with Chatbots & IRC](https://dev.twitch.tv/docs/irc/): New version of this doc.

### 2018-12-19 {#2018-12-19}

[Extensions Guidelines & Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md): New version of this doc.

### 2018-12-17 {#2018-12-17}

[Code Redemption API](https://dev.twitch.tv/docs/api/reference.md#get-code-status) New reference document.

### 2018-11-30 {#2018-11-30}

Extensions Reference: Moved Bits-related reference information (JS helper functions) here, to consolidate all Extensions reference info in one place. The [Bits in Extensions](https://dev.twitch.tv/docs/extensions/monetization.md) document is now purely a guide.

### 2018-11-28 {#2018-11-28}

[Company Management](https://dev.twitch.tv/docs/companies.md): New document on registering companies and managing users in them. Company registration is required before you can manage games on Twitch or create Drops campaigns.

### 2018-11-27 {#2018-11-27}

[Getting Started with Extensions](https://dev.twitch.tv/docs/extensions.md), [Extensions Developer Rig](https://dev.twitch.tv/docs/extensions/rig/): Deleted information about the Developer Rig “local mode" (no longer available).

### 2018-11-14 {#2018-11-14}

[Apps & Authentication: Getting Tokens: OIDC](https://dev.twitch.tv/docs/authentication/getting-tokens-oidc.md): Added claims and UserInfo endpoint.

[Chatbots & IRC Guide](https://dev.twitch.tv/docs/irc): Added scopes for /vip, /unvip, and /vips commands.

[Chatbots & IRC: Twitch Tags](https://dev.twitch.tv/docs/irc/tags/): In [USERNOTICE](https://dev.twitch.tv/docs/irc/tags#usernotice-tags), added anonsubgift.

[PubSub Guide](https://dev.twitch.tv/docs/pubsub/): Added sample message for anonsubgift.

### 2018-11-02 {#2018-11-02}

[Twitch IRC Capability: msd-ID Tags](https://dev.twitch.tv/docs/irc/msg-id/): This new document (under Chatbots & IRC) contains a complete (lengthy) list of all `msg-id` tags that apply to the `NOTICE` (Twitch Commands) and `NOTICE` (Twitch Chat Rooms) commands.

Extensions Reference: New JWT schema field, `is_unlinked`.

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md): New description and example in Get Webhook Subscriptions, which requires a Bearer token.

### 2018-10-24 {#2018-10-24}

[Extensions Guidelines & Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md): New version of this document.

### 2018-10-23 {#2018-10-23}

New Twitch API Reference, New Twitch API: Webhooks Reference: Added a display-name response field to several endpoints and webhooks. Endpoints affected: Get Bits Leaderboard, Get Clips, Get Streams, Get Streams Metadata, Get Stream Markers, Get Users Follows, Get Videos. Webhooks affected: Stream Changed, User Follows.

Building Extensions: Added information about pre-release disclosures. 3/7/19 update: Moved to [Extensions Life Cycle Mangement](https://dev.twitch.tv/docs/extensions/life-cycle.md).

### 2018-10-22 {#2018-10-22}

[Apps & Authentication Guide](https://dev.twitch.tv/docs/authentication.md): In “[Types of Tokens](https://dev.twitch.tv/docs/authentication.md#passing-the-access-token-to-the-api),” added a clarification about bearer tokens.

[New Twitch API Guide](https://dev.twitch.tv/docs/api/guide.md): New information in “[Rate Limits.](https://dev.twitch.tv/docs/api/guide.md#twitch-rate-limits)”

[Getting Started with Extensions](https://dev.twitch.tv/docs/extensions.md): Added the new Extensions Developer Sandbox.

### 2018-10-16 {#2018-10-16}

Extensions: Onboarding is now required only for monetization (Bits).

* [Extensions Developer Rig](https://dev.twitch.tv/docs/extensions/rig/): The rig no longer requires prior onboarding.
* [Bits in Extensions Guide](https://dev.twitch.tv/docs/extensions/monetization.md): A new onboarding procedure is described.

### 2018-10-10 {#2018-10-10}

Extensions: Added the new Configuration Service. See:

* [Building Extensions](https://dev.twitch.tv/docs/extensions/building.md): New “Configuration Service” section.
* Extensions Reference:
  * Three new endpoints (Set Extension Configuration Segment, Get Extension Channel Configuration, Get Extension Configuration Segment).
  * New Twitch Extensions configuration helper functions (see "Helper: Configuration").
  * Change to when Set Extension Required Configuration can be used.
* [Extensions Developer Rig](https://dev.twitch.tv/docs/extensions/rig/): New Configuration Service tab.
* Releasing & Maintaining Extensions: Many updates. 3/7/19 update: Renamed [Extensions Life Cycle Management](https://dev.twitch.tv/docs/extensions/life-cycle.md).

[Insights & Analytics](https://dev.twitch.tv/docs/insights.md): Added printing a poster view of Twitch Quarterly Insights.

### 2018-10-09 {#2018-10-09}

[Chatbots & IRC: Twitch Commands](https://dev.twitch.tv/docs/irc/commands/), [Chatbots & IRC: Twitch Tags](https://dev.twitch.tv/docs/irc/tags/): Added CLEARMSG, single-message removal on a channel.

### 2018-10-02 {#2018-10-02}

[Drops Guide](https://dev.twitch.tv/docs/drops.md): Added recommendations for campaigns.

Webhooks Reference: Clarified the functionality of the Stream Changed webhook (formerly called Stream Up/Down).

### 2018-10-01 {#2018-10-01}

[Drops Guide](https://dev.twitch.tv/docs/drops.md): New functionality for creating and using items, with a new Item Manager page and new fields for items. See especially the section on using campaigns.

### 2018-09-28 {#2018-09-28}

[Extensions Developer Rig](https://dev.twitch.tv/docs/extensions/rig/): New document focusing on the rig. Also see changes to the Developer Rig section of [Getting Started with Extensions](https://dev.twitch.tv/docs/extensions.md).

Extensions Reference: New `hostingInfo` property in the `onContext` JS helper function. New `onHighlightChanged` JS helper function.

[Apps & Authentication Guide](https://dev.twitch.tv/docs/authentication.md): The `chat_login` scope is deprecated. See the section on new scopes for chat and PubSub.

[Chatbots & IRC Guide](https://dev.twitch.tv/docs/irc): New section on Scopes for IRC Commands.

[Mobile Deep Links](https://dev.twitch.tv/docs/mobile-deeplinks.md): New section on launching the Twitch app with universal links (recommended).

### 2018-09-14 {#2018-09-14}

New Twitch API: Webhooks Guide: There are changes to subscription limits. Each client ID can have at most 10,000 subscriptions. Also, you can subscribe to the same topic at most 3 times.

### 2018-09-11 {#2018-09-11}

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md): New optional query string parameters (`started_at` and `ended_at`) for [Get Clips](https://dev.twitch.tv/docs/api/reference/clips.md#get-clips).

### 2018-09-07 {#2018-09-07}

Extensions Reference: New JS helper function, `minimize`. See Helper: Actions.

### 2018-09-06 {#2018-09-06}

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md): Added new endpoints, [Create Stream Marker](https://dev.twitch.tv/docs/api/reference/streams.md#create-stream-marker) and [Get Stream Markers](https://dev.twitch.tv/docs/api/reference/streams.md#get-stream-markers).

### 2018-09-04 {#2018-09-04}

[Insights & Analytics](https://dev.twitch.tv/docs/insights.md): Added three new clips fields to [game-developer analytics](https://dev.twitch.tv/docs/insights.md#game-developer-analytics).

### 2018-09-03 {#2018-09-03}

[Getting Started with the New Twitch API](https://dev.twitch.tv/docs/api.md): When registering your app, the app name must not include "Twitch" (as an exact or fuzzy match), or registration will fail.

### 2018-08-30 {#2018-08-30}

Extensions (several docs): Added pop-out Extensions. Start reading [here](https://dev.twitch.tv/docs/extensions/required-technical-background.md#pop-out-extensions) in Required Technical Background (this links to relevant info elsewhere in the doc set).

Extensions Reference: Added Send Extension Chat Message endpoint and Helper: Feature Flags (JS helper functions).

### 2018-08-21 {#2018-08-21}

[Insights & Analytics](https://dev.twitch.tv/docs/insights.md): Added Twitch Quarterly Insights (fact sheet for games).

### 2018-08-13 {#2018-08-13}

[Building Extensions](https://dev.twitch.tv/docs/extensions/building.md): Due to requirements recently communicated to us by Apple, Extensions support on iOS devices (including the ability to test on iOS) is now restricted to Apple Developer Program members. See "[Mobile Support](https://dev.twitch.tv/docs/extensions/building.md#mobile-support)."

* If you have released a mobile extension: Your extension no longer appears on iOS. Twitch will contact you soon about adding iOS support.
* If you develop a new mobile extension for iOS, please set up an Apple developer account (if you do not already have one), then contact Twitch (developer_support@twitch.tv) to add iOS support.

Extensions Reference: In Helper: Extensions, added new property (`arePlayerControlsVisible`) to the `onContext` JS helper function.

### 2018-08-07 {#2018-08-07}

[Insights & Analytics](https://dev.twitch.tv/docs/insights.md) Added V2 of extension analytics.

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md) Updated the [Get Extension Analytics](https://dev.twitch.tv/docs/api/reference/analytics.md#get-extension-analytics) endpoint for V2.

New Twitch API: Webhooks Reference Added new webhook, Extension Analytics.

### 2018-08-02 {#2018-08-02}

[Chatbots & IRC: Twitch Tags](https://dev.twitch.tv/docs/irc/tags/): Marked some parameters as deprecated (`subscriber`, `turbo`, and `user_type`). Use the `badges` parameter instead.

### 2018-07-31 {#2018-07-31}

New Twitch API Reference: Added Get Webhook Subscriptions endpoint.

### 2018-07-27 {#2018-07-27}

[Designing Extensions](https://dev.twitch.tv/docs/extensions/designing.md): Added more guidance for all extensions and panel extensions.

### 2018-07-20 {#2018-07-20}

[Apps & Authentication: Guide](https://dev.twitch.tv/docs/authentication.md), [Getting Tokens: OAuth](https://dev.twitch.tv/docs/authentication/getting-tokens-oauth.md), & [Getting Tokens: OIDC](https://dev.twitch.tv/docs/authentication/getting-tokens-oidc.md): Added `token_type` parameter (required value = `bearer`) in several places.

### 2018-07-19 {#2018-07-19}

[Bits in Extensions](https://dev.twitch.tv/docs/extensions/monetization.md): New document.

[Extensions Guidelines & Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md): Added Bits in Extensions requirements.

### 2018-07-12 {#2018-07-12}

Twitch API v5 Channel Feed Reference: Changed (deprecated) most endpoint responses.

### 2018-07-06 {#2018-07-06}

[Getting Started with Extensions](https://dev.twitch.tv/docs/extensions.md), [Building Extensions](https://dev.twitch.tv/docs/extensions/building.md): Added information about the Twitch Developer Rig “local mode” (for local testing against mock, non-production endpoints).

[Extensions Guidelines & Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md): Added a note about which versions of Android and iOS must be supported by mobile extensions.

Extensions Reference: Added two new fields to the `onContext` JS helper function (`isMuted`, `volume`).

[Apps & Authentication](https://dev.twitch.tv/docs/authentication.md): Split this large document into several smaller docs, to make it easier to read and find information.

### 2018-06-22 {#2018-06-22}

[Insights & Analytics](https://dev.twitch.tv/docs/insights.md): Added V2 of game analytics.

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md): Updated the [Get Game Analytics](https://dev.twitch.tv/docs/api/reference/analytics.md#get-game-analytics) endpoint, to enable selection of report version and date/time range.

[Chatbots & IRC Guide](https://dev.twitch.tv/docs/irc): Updated the information on "Connecting to Twitch IRC."

### 2018-06-19 {#2018-06-19}

Extensions Reference: Expanded the definition of `onPositionChanged` JS helper function.

[Building Extensions](https://dev.twitch.tv/docs/extensions/building.md) In “Local Test,” added information about the new Invite Only tab, for seeing allowlisted extensions in the Extensions Manager.

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md) Added three endpoints: Get User Extensions, Get User Active Extensions, Update User Installed Extensions.

[Apps & Authentication](https://dev.twitch.tv/docs/authentication.md) Added new scopes, for new endpoints.

[Embedding Twitch: Everything](https://dev.twitch.tv/docs/embed/everything.md) For the `layout` parameter, changed the valid value from `video-and-chat` to `video-with-chat`.

Twitch API v5 In “Which API Version Can You Use?” indicated that there is no scheduled deletion date for v5.

### 2018-06-07 {#2018-06-07}

[Embedding Video & Clips](https://dev.twitch.tv/docs/embed/video-and-clips.md): In `setVideo`, added a new `Timestamp` parameter.

[Drops Guide](https://dev.twitch.tv/docs/drops.md): In "Next: Notify the Viewer about Drops," added GUID to URLs.

### 2018-06-04 {#2018-06-04}

Having Extensions Reviewed: Before you submit an extension for review, you now select a category under which your extension will be shown in the Extension Manager and upload an image for "discovery" purposes. 3/7/19 update: This document was deleted; information is in [Extensions Life Cycle Management](https://dev.twitch.tv/docs/extensions/life-cycle.md).

### 2018-05-31 {#2018-05-31}

Getting Started docs:

* [Getting Started with Extensions](https://dev.twitch.tv/docs/extensions.md): Added links to new videos.
* [Getting Started with Chatbots & IRC](https://dev.twitch.tv/docs/irc/): New doc.
* [Getting Started with the New Twitch API](https://dev.twitch.tv/docs/api.md): New doc.

Extensions Reference: Changes to Send Extension PubSub Message (messages can be sent globally), `listen` and `send` JS Helper functions, and Example JWT Payload.

<!-- [New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md): Added pagination parameters and additional example to Get Game Analytics. Added Get Extension Analytics endpoint. -->

New Twitch API: Webhooks Reference: Added two webhooks (User Changed, Game Analytics).

[Insights & Analytics](https://dev.twitch.tv/docs/insights.md): New doc, with information on both game developer analytics and extensions developer analytics. (Replaces the Game Developer Analytics doc.)

### 2018-05-21 {#2018-05-21}

[Embedding Twitch](https://dev.twitch.tv/docs/embed.md) and [Chatbots & IRC](https://dev.twitch.tv/docs/irc/): These large documents were spit into several smaller docs, to make it easier to read and find information.

Extensions Reference: The `onVisibilityChanged` JS helper function now works with component extensions.

### 2018-05-15 {#2018-05-15}

[Getting Started with Extensions](https://dev.twitch.tv/docs/extensions.md): In “Procedure for Non-Twitch Partners/Affiliates,” the last step of beginning the onboarding process was changed.

### 2018-05-09 {#2018-05-09}

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md):

* In [Create Clip](https://dev.twitch.tv/docs/api/reference/clips.md#create-clip), an optional query string parameter was added, `has_delay`. This adds a delay before the clip is captured to account for the brief delay between the broadcaster’s stream and the viewer's experience of that stream.

### 2018-05-02 {#2018-05-02}

[Extensions](https://dev.twitch.tv/docs/extensions.md) The Extensions Guide was split into several shorter docs. Look in the Extensions doc category.

### 2018-04-29 {#2018-04-29}

Updated [Organizations](https://dev.twitch.tv/docs/companies.md#how-to-register-an-organization) documentation.

### 2018-04-19 {#2018-04-19}

[Embedding Video and Clips](https://dev.twitch.tv/docs/embed/video-and-clips.md): In “Interactive Frames for Live Streams and VODs” > “Optional Parameter,” the default of the parameter `playsinline` parameter was changed to `true`.

Extensions Guide: Video-component extensions were added. Broadcasters can activate up to six extensions at a time: 3 panel, 1 video overlay (full screen), and 2 video component (smaller).

Extensions Reference: Info was added about video-component extensions (new JS Helper function, `onPositionChanged`).

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md): In Get Clip, 4 query params were added (`broadcaster_id`, `game_id`, `before`, `after`).

### 2018-04-04 {#2018-04-04}

[Embedding Video and Clips](https://dev.twitch.tv/docs/embed/video-and-clips.md): In “Events Emitted by and Defined by the Player,” a new  `Twitch.Player.PLAYBACK_BLOCKED` event was added.

[New Twitch API Reference](https://dev.twitch.tv/docs/api/reference.md): A “Resource” column was added to the summary table of endpoints, then endpoints in the doc were re-ordered to match the table (so endpoints for the same resource are in the same part of the doc).

### 2018-03-29 {#2018-03-29}

[Apps & Authentication Guide](https://dev.twitch.tv/docs/authentication.md): See new wording in “Validating Requests.”

[Embedding Video and Clips](https://dev.twitch.tv/docs/embed/video-and-clips.md): In “Interactive Frames for Live Streams and VODs” > “Events Emitted by and Defined by the Player,” a new `PLAYING` event was added and the definition of the `PLAY` event was changed.

Extensions Guide: In “Appendix B: Guidelines and Practices,” the policy for audio was revised: “Extensions can include audio only if they include controls which allow viewers to adjust the volume, and by default, these controls are set to off/muted.” 5/2/18 update: Now that the Extensions Guide is split up, this information is in [Extensions Guidelines & Policies](https://dev.twitch.tv/docs/extensions/guidelines-and-policies.md).

Extensions Reference: Changes related to the introduction of dynamic anchors. Search for “anchor” in the doc.
