Skip to content

Commit 6707d6e

Browse files
committed
Docs for eventsub payloads
1 parent 9193844 commit 6707d6e

File tree

2 files changed

+76
-4
lines changed

2 files changed

+76
-4
lines changed

docs/references/events.rst

Lines changed: 75 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,216 +13,288 @@ All events are prefixed with **event_**
1313
* - Type
1414
- Subscription
1515
- Event
16+
- Payload
1617
* - Automod Message Hold
1718
- :meth:`~eventsub.AutomodMessageHoldSubscription`
1819
- automod_message_hold
20+
- :class:`~models.eventsub_.AutomodMessageHold`
1921
* - Automod Message Update
2022
- :meth:`~eventsub.AutomodMessageUpdateSubscription`
2123
- automod_message_update
24+
- :class:`~models.eventsub_.AutomodMessageUpdate`
2225
* - Automod Settings Update
2326
- :meth:`~eventsub.AutomodSettingsUpdateSubscription`
2427
- automod_settings_update
28+
- :class:`~models.eventsub_.AutomodSettingsUpdate`
2529
* - Automod Terms Update
2630
- :meth:`~eventsub.AutomodTermsUpdateSubscription`
2731
- automod_terms_update
32+
- :class:`~models.eventsub_.AutomodTermsUpdate`
2833
* - Channel Update
2934
- :meth:`~eventsub.ChannelUpdateSubscription`
3035
- channel_update
36+
- :class:`~models.eventsub_.ChannelUpdate`
3137
* - Channel Follow
3238
- :meth:`~eventsub.ChannelFollowSubscription`
3339
- follow
40+
- :class:`~models.eventsub_.ChannelFollow`
3441
* - Channel Ad Break Begin
3542
- :meth:`~eventsub.AdBreakBeginSubscription`
3643
- ad_break
44+
- :class:`~models.eventsub_.ChannelAdBreakBegin`
3745
* - Channel Chat Clear
3846
- :meth:`~eventsub.ChatClearSubscription`
3947
- chat_clear
48+
- :class:`~models.eventsub_.ChannelChatClear`
4049
* - Channel Chat Clear User Messages
4150
- :meth:`~eventsub.ChatClearUserMessagesSubscription`
4251
- chat_clear_user
52+
- :class:`~models.eventsub_.ChannelChatClearUserMessages`
4353
* - Channel Chat Message
4454
- :meth:`~eventsub.ChatMessageSubscription`
4555
- message
56+
- :class:`~models.eventsub_.ChatMessage`
4657
* - Channel Chat Message Delete
47-
- :meth:`~eventsub.ChatNotificationSubscription`
48-
- message_delete
49-
* - Channel Chat Notification
5058
- :meth:`~eventsub.ChatMessageDeleteSubscription`
59+
- message_delete
60+
- :class:`~models.eventsub_.ChatMessageDelete`
61+
* - Channel Chat Notification
62+
- :meth:`~eventsub.ChatNotificationSubscription`
5163
- chat_notification
64+
- :class:`~models.eventsub_.ChatNotification`
5265
* - Channel Chat Settings Update
5366
- :meth:`~eventsub.ChatSettingsUpdateSubscription`
5467
- chat_settings_update
68+
- :class:`~models.eventsub_.ChatSettingsUpdate`
5569
* - Channel Chat User Message Hold
5670
- :meth:`~eventsub.ChatUserMessageHoldSubscription`
5771
- chat_user_message_hold
72+
- :class:`~models.eventsub_.ChatUserMessageHold`
5873
* - Channel Chat User Message Update
5974
- :meth:`~eventsub.ChatUserMessageUpdateSubscription`
6075
- chat_user_message_update
76+
- :class:`~models.eventsub_.ChatUserMessageUpdate`
6177
* - Channel Shared Chat Session Begin
6278
- :meth:`~eventsub.SharedChatSessionBeginSubscription`
6379
- shared_chat_begin
80+
- :class:`~models.eventsub_.SharedChatSessionBegin`
6481
* - Channel Shared Chat Session Update
6582
- :meth:`~eventsub.SharedChatSessionUpdateSubscription`
6683
- shared_chat_update
84+
- :class:`~models.eventsub_.SharedChatSessionUpdate`
6785
* - Channel Shared Chat Session End
6886
- :meth:`~eventsub.SharedChatSessionEndSubscription`
6987
- shared_chat_end
88+
- :class:`~models.eventsub_.SharedChatSessionEnd`
7089
* - Channel Subscribe
7190
- :meth:`~eventsub.ChannelSubscribeSubscription`
7291
- subscription
92+
- :class:`~models.eventsub_.ChannelSubscribe`
7393
* - Channel Subscription End
7494
- :meth:`~eventsub.ChannelSubscriptionEndSubscription`
7595
- subscription_end
96+
- :class:`~models.eventsub_.ChannelSubscriptionEnd`
7697
* - Channel Subscription Gift
7798
- :meth:`~eventsub.ChannelSubscriptionGiftSubscription`
7899
- subscription_gift
100+
- :class:`~models.eventsub_.ChannelSubscriptionGift`
79101
* - Channel Subscription Message
80102
- :meth:`~eventsub.ChannelSubscribeMessageSubscription`
81103
- subscription_message
104+
- :class:`~models.eventsub_.ChannelSubscriptionMessage`
82105
* - Channel Cheer
83106
- :meth:`~eventsub.ChannelCheerSubscription`
84107
- cheer
108+
- :class:`~models.eventsub_.ChannelCheer`
85109
* - Channel Raid
86110
- :meth:`~eventsub.ChannelRaidSubscription`
87111
- raid
112+
- :class:`~models.eventsub_.ChannelRaid`
88113
* - Channel Ban
89114
- :meth:`~eventsub.ChannelBanSubscription`
90115
- ban
116+
- :class:`~models.eventsub_.ChannelBan`
91117
* - Channel Unban
92118
- :meth:`~eventsub.ChannelUnbanSubscription`
93119
- unban
120+
- :class:`~models.eventsub_.ChannelUnban`
94121
* - Channel Unban Request Create
95122
- :meth:`~eventsub.ChannelUnbanRequestSubscription`
96123
- unban_request
124+
- :class:`~models.eventsub_.ChannelUnbanRequest`
97125
* - Channel Unban Request Resolve
98126
- :meth:`~eventsub.ChannelUnbanRequestResolveSubscription`
99127
- unban_request_resolve
128+
- :class:`~models.eventsub_.ChannelUnbanRequestResolve`
100129
* - Channel Moderate
101130
- :meth:`~eventsub.ChannelModerateSubscription`
102131
- mod_action
132+
- :class:`~models.eventsub_.ChannelModerate`
103133
* - Channel Moderate V2
104134
- :meth:`~eventsub.ChannelModerateV2Subscription`
105135
- mod_action
136+
- :class:`~models.eventsub_.ChannelModerate`
106137
* - Channel Moderator Add
107138
- :meth:`~eventsub.ChannelModeratorAddSubscription`
108139
- moderator_add
140+
- :class:`~models.eventsub_.ChannelModeratorAdd`
109141
* - Channel Moderator Remove
110142
- :meth:`~eventsub.ChannelModeratorRemoveSubscription`
111143
- moderator_remove
144+
- :class:`~models.eventsub_.ChannelModeratorRemove`
112145
* - Channel Points Automatic Reward Redemption
113146
- :meth:`~eventsub.ChannelPointsAutoRedeemSubscription`
114147
- automatic_redemption_add
148+
- :class:`~models.eventsub_.ChannelPointsAutoRedeemAdd`
115149
* - Channel Points Custom Reward Add
116150
- :meth:`~eventsub.ChannelPointsRewardAddSubscription`
117151
- custom_reward_add
152+
- :class:`~models.eventsub_.ChannelPointsRewardAdd`
118153
* - Channel Points Custom Reward Update
119154
- :meth:`~eventsub.ChannelPointsRewardUpdateSubscription`
120155
- custom_reward_update
156+
- :class:`~models.eventsub_.ChannelPointsRewardUpdate`
121157
* - Channel Points Custom Reward Remove
122158
- :meth:`~eventsub.ChannelPointsRewardRemoveSubscription`
123159
- custom_reward_remove
160+
- :class:`~models.eventsub_.ChannelPointsRewardRemove`
124161
* - Channel Points Custom Reward Redemption Add
125162
- :meth:`~eventsub.ChannelPointsRedeemAddSubscription`
126163
- custom_redemption_add
164+
- :class:`~models.eventsub_.ChannelPointsRedemptionAdd`
127165
* - Channel Points Custom Reward Redemption Update
128166
- :meth:`~eventsub.ChannelPointsRedeemUpdateSubscription`
129167
- custom_redemption_update
168+
- :class:`~models.eventsub_.ChannelPointsRedemptionUpdate`
130169
* - Channel Poll Begin
131170
- :meth:`~eventsub.ChannelPollBeginSubscription`
132171
- poll_begin
172+
- :class:`~models.eventsub_.ChannelPollBegin`
133173
* - Channel Poll Progress
134174
- :meth:`~eventsub.ChannelPollProgressSubscription`
135175
- poll_progress
176+
- :class:`~models.eventsub_.ChannelPollProgress`
136177
* - Channel Poll End
137178
- :meth:`~eventsub.ChannelPollEndSubscription`
138179
- poll_end
180+
- :class:`~models.eventsub_.ChannelPollEnd`
139181
* - Channel Prediction Begin
140182
- :meth:`~eventsub.ChannelPredictionBeginSubscription`
141183
- prediction_begin
184+
- :class:`~models.eventsub_.ChannelPredictionBegin`
142185
* - Channel Prediction Progress
143186
- :meth:`~eventsub.ChannelPredictionProgressSubscription`
144187
- prediction_progress
188+
- :class:`~models.eventsub_.ChannelPredictionProgress`
145189
* - Channel Prediction Lock
146190
- :meth:`~eventsub.ChannelPredictionLockSubscription`
147191
- prediction_lock
192+
- :class:`~models.eventsub_.ChannelPredictionLock`
148193
* - Channel Prediction End
149194
- :meth:`~eventsub.ChannelPredictionEndSubscription`
150195
- prediction_end
196+
- :class:`~models.eventsub_.ChannelPredictionEnd`
151197
* - Channel Suspicious User Message
152198
- :meth:`~eventsub.SuspiciousUserMessageSubscription`
153199
- suspicious_user_message
200+
- :class:`~models.eventsub_.SuspiciousUserMessage`
154201
* - Channel Suspicious User Update
155202
- :meth:`~eventsub.SuspiciousUserUpdateSubscription`
156203
- suspicious_user_update
204+
- :class:`~models.eventsub_.SuspiciousUserUpdate`
157205
* - Channel VIP Add
158206
- :meth:`~eventsub.ChannelVIPAddSubscription`
159207
- vip_add
208+
- :class:`~models.eventsub_.ChannelVIPAdd`
160209
* - Channel VIP Remove
161210
- :meth:`~eventsub.ChannelVIPRemoveSubscription`
162211
- vip_remove
212+
- :class:`~models.eventsub_.ChannelVIPRemove`
163213
* - Channel Warning Acknowledgement
164214
- :meth:`~eventsub.ChannelWarningAcknowledgementSubscription`
165215
- warning_acknowledge
216+
- :class:`~models.eventsub_.ChannelWarningAcknowledge`
166217
* - Channel Warning Send
167218
- :meth:`~eventsub.ChannelWarningSendSubscription`
168219
- warning_send
220+
- :class:`~models.eventsub_.ChannelWarningSend`
169221
* - Charity Donation
170222
- :meth:`~eventsub.CharityDonationSubscription`
171223
- charity_campaign_donate
224+
- :class:`~models.eventsub_.ChannelWarningSend`
172225
* - Charity Campaign Start
173226
- :meth:`~eventsub.CharityCampaignStartSubscription`
174227
- charity_campaign_start
228+
- :class:`~models.eventsub_.CharityCampaignStart`
175229
* - Charity Campaign Progress
176230
- :meth:`~eventsub.CharityCampaignProgressSubscription`
177231
- charity_campaign_progress
232+
- :class:`~models.eventsub_.CharityCampaignProgress`
178233
* - Charity Campaign Stop
179234
- :meth:`~eventsub.CharityCampaignStopSubscription`
180235
- charity_campaign_stop
236+
- :class:`~models.eventsub_.CharityCampaignStop`
181237
* - Goal Begin
182238
- :meth:`~eventsub.GoalBeginSubscription`
183239
- goal_begin
240+
- :class:`~models.eventsub_.GoalBegin`
184241
* - Goal Progress
185242
- :meth:`~eventsub.GoalProgressSubscription`
186243
- goal_progress
244+
- :class:`~models.eventsub_.GoalProgress`
187245
* - Goal End
188246
- :meth:`~eventsub.GoalEndSubscription`
189247
- goal_end
248+
- :class:`~models.eventsub_.GoalEnd`
190249
* - Hype Train Begin
191250
- :meth:`~eventsub.HypeTrainBeginSubscription`
192251
- hype_train
252+
- :class:`~models.eventsub_.HypeTrainBegin`
193253
* - Hype Train Progress
194254
- :meth:`~eventsub.HypeTrainProgressSubscription`
195255
- hype_train_progress
256+
- :class:`~models.eventsub_.HypeTrainProgress`
196257
* - Hype Train End
197258
- :meth:`~eventsub.HypeTrainEndSubscription`
198259
- hype_train_end
260+
- :class:`~models.eventsub_.HypeTrainEnd`
199261
* - Shield Mode Begin
200262
- :meth:`~eventsub.ShieldModeBeginSubscription`
201263
- shield_mode_begin
264+
- :class:`~models.eventsub_.ShieldModeBegin`
202265
* - Shield Mode End
203266
- :meth:`~eventsub.ShieldModeEndSubscription`
204267
- shield_mode_end
268+
- :class:`~models.eventsub_.ShieldModeEnd`
205269
* - Shoutout Create
206270
- :meth:`~eventsub.ShoutoutCreateSubscription`
207271
- shoutout_create
272+
- :class:`~models.eventsub_.ShoutoutCreate`
208273
* - Shoutout Received
209274
- :meth:`~eventsub.ShoutoutReceiveSubscription`
210275
- shoutout_receive
276+
- :class:`~models.eventsub_.ShoutoutReceive`
211277
* - Stream Online
212278
- :meth:`~eventsub.StreamOnlineSubscription`
213279
- stream_online
280+
- :class:`~models.eventsub_.StreamOnline`
214281
* - Stream Offline
215282
- :meth:`~eventsub.StreamOfflineSubscription`
216283
- stream_offline
284+
- :class:`~models.eventsub_.StreamOffline`
217285
* - User Authorization Grant
218286
- :meth:`~eventsub.UserAuthorizationGrantSubscription`
219287
- user_authorization_grant
288+
- :class:`~models.eventsub_.UserAuthorizationGrant`
220289
* - User Authorization Revoke
221290
- :meth:`~eventsub.UserAuthorizationRevokeSubscription`
222291
- user_authorization_revoke
292+
- :class:`~models.eventsub_.UserAuthorizationRevoke`
223293
* - User Update
224294
- :meth:`~eventsub.UserUpdateSubscription`
225295
- user_update
296+
- :class:`~models.eventsub_.UserUpdate`
226297
* - Whisper Received
227298
- :meth:`~eventsub.WhisperReceivedSubscription`
228299
- message_whisper
300+
- :class:`~models.eventsub_.Whisper`

twitchio/models/eventsub_.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4674,7 +4674,7 @@ class UserUpdate(BaseEvent):
46744674
"""
46754675
Represents a user update event.
46764676
4677-
??? note
4677+
.. note::
46784678
The email attribute requires the `user:read:email` scope otherwise it is None.
46794679
46804680
Attributes

0 commit comments

Comments
 (0)