Skip to content

Scheduled Event Exceptions #8389

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Droid00000 wants to merge 34 commits into
base: main
Choose a base branch
from
Open

Scheduled Event Exceptions #8389

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
a31fcbd
Droid - Document Guild Scheduled Event Exceptions
Droid00000 Nov 30, 2025
47961ec
Droid - Fix wrong field names
Droid00000 Jan 9, 2026
0ab2dc5
Merge remote-tracking branch 'origin/current' into feat/scheduled-eve…
Droid00000 Feb 11, 2026
32a5c74
Droid - Properly reference ISO8601 format
Droid00000 Feb 11, 2026
1091591
Droid - Clarify that changing the recurrence_rule may delete exceptions
Droid00000 Feb 20, 2026
f43dd19
Merge branch 'main' into feat/scheduled-event-exceptions
Droid00000 Mar 9, 2026
6fd706c
Droid - Document shared client theme
Droid00000 Nov 7, 2025
e6624d2
Merge branch 'main' into feat/scheduled-event-exceptions
Droid00000 Mar 20, 2026
56f3b02
Merge branch 'main' into feat/scheduled-event-exceptions
Droid00000 Apr 17, 2026
43144a2
Merge branch 'main' into feat/scheduled-event-exceptions
Droid00000 Apr 20, 2026
95f7d8a
Remove 204 response
Droid00000 Jun 8, 2026
b031def
link to array query string params
Droid00000 Jun 8, 2026
e474c2b
add missing error code
Droid00000 Jun 9, 2026
ea9a317
extra note
Droid00000 Jun 9, 2026
046cd2a
add back missing field
Droid00000 Jun 9, 2026
db53055
Update guild-scheduled-event.mdx
Droid00000 Jun 9, 2026
291c0f9
fix tables
Droid00000 Jun 9, 2026
aa479c9
fix spacing
Droid00000 Jun 9, 2026
d03ba5c
fix spacing
Droid00000 Jun 9, 2026
8378154
Apply suggestions from code review
Droid00000 Jun 10, 2026
af21399
Update opcodes-and-status-codes.mdx
Droid00000 Jun 10, 2026
04ca1ce
actually fix the tables
Droid00000 Jun 10, 2026
b288e23
Update guild-scheduled-event.mdx
Droid00000 Jun 12, 2026
55b0f1c
Merge branch 'discord:main' into scheduled-event-exceptions
Droid00000 Jun 15, 2026
ac2b9be
Update developers/resources/guild-scheduled-event.mdx
Droid00000 Jun 18, 2026
e9688ef
use the same consistent variable name
Droid00000 Jun 18, 2026
3adcd46
add event_exception_id
Droid00000 Jun 21, 2026
72a7e3f
note that while all exception IDs are recurrence IDs not all recurren…
Droid00000 Jun 21, 2026
7df5c09
Merge remote-tracking branch 'upstream/main' into scheduled-event-exc…
Droid00000 Jun 21, 2026
b9f6c5f
fix botched conflict
Droid00000 Jun 21, 2026
24d670e
Merge branch 'main' into scheduled-event-exceptions
Droid00000 Jun 21, 2026
c55f799
optional parameters are reset to their default values
Droid00000 Jun 22, 2026
5afc3b6
conform to the API spec
Droid00000 Jun 22, 2026
a8fb49a
is_canceled is nullable as well
Droid00000 Jun 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 27 additions & 10 deletions developers/events/gateway-events.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -428,6 +428,9 @@ Receive events are Gateway events encapsulated in an [event payload](/developers
| [Webhooks Update](/developers/events/gateway-events#webhooks-update) | Guild channel webhook was created, update, or deleted |
| [Message Poll Vote Add](/developers/events/gateway-events#message-poll-vote-add) | User voted on a poll |
| [Message Poll Vote Remove](/developers/events/gateway-events#message-poll-vote-remove) | User removed a vote on a poll |
| [Guild Scheduled Event Exception Create](/developers/events/gateway-events#guild-scheduled-event-exception-create) | Guild scheduled event exception was created |
| [Guild Scheduled Event Exception Update](/developers/events/gateway-events#guild-scheduled-event-exception-update) | Guild scheduled event exception was updated |
| [Guild Scheduled Event Exception Delete](/developers/events/gateway-events#guild-scheduled-event-exception-delete) | Guild scheduled event exception was deleted |

#### Hello

Expand Down Expand Up @@ -969,11 +972,12 @@ Sent when a user has subscribed to a guild scheduled event.
<ManualAnchor id="guild-scheduled-event-user-add-guild-scheduled-event-user-add-event-fields" />
###### Guild Scheduled Event User Add Event Fields

| Field | Type | Description |
|--------------------------|-----------|---------------------------------|
| guild_scheduled_event_id | snowflake | ID of the guild scheduled event |
| user_id | snowflake | ID of the user |
| guild_id | snowflake | ID of the guild |
| Field | Type | Description |
|-------------------------------------|-----------|----------------------------------------------------------|
| guild_scheduled_event_id | snowflake | ID of the guild scheduled event |
| user_id | snowflake | ID of the user |
| guild_id | snowflake | ID of the guild |
| guild_scheduled_event_exception_id? | snowflake | ID of the guild scheduled event exception, if applicable |

#### Guild Scheduled Event User Remove

Expand All @@ -982,11 +986,24 @@ Sent when a user has unsubscribed from a guild scheduled event.
<ManualAnchor id="guild-scheduled-event-user-remove-guild-scheduled-event-user-remove-event-fields" />
###### Guild Scheduled Event User Remove Event Fields

| Field | Type | Description |
|--------------------------|-----------|---------------------------------|
| guild_scheduled_event_id | snowflake | ID of the guild scheduled event |
| user_id | snowflake | ID of the user |
| guild_id | snowflake | ID of the guild |
| Field | Type | Description |
|-------------------------------------|-----------|----------------------------------------------------------|
| guild_scheduled_event_id | snowflake | ID of the guild scheduled event |
| user_id | snowflake | ID of the user |
| guild_id | snowflake | ID of the guild |
| guild_scheduled_event_exception_id? | snowflake | ID of the guild scheduled event exception, if applicable |

#### Guild Scheduled Event Exception Create

Sent when a guild scheduled event exception is created. The inner payload is a [guild scheduled event exception](/developers/resources/guild-scheduled-event#guild-scheduled-event-exception-object) object with an additional `guild_id` key.

#### Guild Scheduled Event Exception Update

Sent when a guild scheduled event exception is updated. The inner payload is a [guild scheduled event exception](/developers/resources/guild-scheduled-event#guild-scheduled-event-exception-object) object with an additional `guild_id` key.

#### Guild Scheduled Event Exception Delete

Sent when a guild scheduled event exception is deleted. The inner payload is a [guild scheduled event exception](/developers/resources/guild-scheduled-event#guild-scheduled-event-exception-object) object with an additional `guild_id` key.

#### Guild Soundboard Sound Create

Expand Down
3 changes: 3 additions & 0 deletions developers/events/gateway.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -408,6 +408,9 @@ GUILD_SCHEDULED_EVENTS (1 << 16)
- GUILD_SCHEDULED_EVENT_DELETE
- GUILD_SCHEDULED_EVENT_USER_ADD
- GUILD_SCHEDULED_EVENT_USER_REMOVE
- GUILD_SCHEDULED_EVENT_EXCEPTION_CREATE
- GUILD_SCHEDULED_EVENT_EXCEPTION_UPDATE
- GUILD_SCHEDULED_EVENT_EXCEPTION_DELETE

AUTO_MODERATION_CONFIGURATION (1 << 20)
- AUTO_MODERATION_RULE_CREATE
Expand Down
4 changes: 4 additions & 0 deletions developers/resources/audit-log.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -155,6 +155,9 @@ You should assume that your app may run into any field for the changed object, t
| HOME_SETTINGS_UPDATE | 191 | Guild Server Guide was updated | |
| VOICE_CHANNEL_STATUS_CREATE | 192 | A voice channel status was set by a user | |
| VOICE_CHANNEL_STATUS_DELETE | 193 | A voice channel status was deleted by a user | |
| GUILD_SCHEDULED_EVENT_EXCEPTION_CREATE | 200 | Guild Scheduled Event Exception was created | [Guild Scheduled Event Exception](/developers/resources/guild-scheduled-event#guild-scheduled-event-exception-object) |
| GUILD_SCHEDULED_EVENT_EXCEPTION_UPDATE | 201 | Guild Scheduled Event Exception was updated | [Guild Scheduled Event Exception](/developers/resources/guild-scheduled-event#guild-scheduled-event-exception-object) |
| GUILD_SCHEDULED_EVENT_EXCEPTION_DELETE | 202 | Guild Scheduled Event Exception was deleted | [Guild Scheduled Event Exception](/developers/resources/guild-scheduled-event#guild-scheduled-event-exception-object) |


\* Object has exception(s) to available keys. See the [exceptions](/developers/resources/audit-log#audit-log-change-object-audit-log-change-exceptions) section below for details.
Expand All @@ -177,6 +180,7 @@ You should assume that your app may run into any field for the changed object, t
| type | string | Type of overwritten entity - role (`"0"`) or member (`"1"`) | CHANNEL_OVERWRITE_CREATE & CHANNEL_OVERWRITE_UPDATE & CHANNEL_OVERWRITE_DELETE |
| integration_type | string | The type of integration which performed the action | MEMBER_KICK & MEMBER_ROLE_UPDATE |
| status | string | The new voice channel status | VOICE_CHANNEL_STATUS_CREATE |
| event_exception_id | snowflake | ID of the guild scheduled event exception that was targeted | GUILD_SCHEDULED_EVENT_EXCEPTION_CREATE & GUILD_SCHEDULED_EVENT_EXCEPTION_UPDATE & GUILD_SCHEDULED_EVENT_EXCEPTION_DELETE |

### Audit Log Change Object

Expand Down
Loading