feat: Add support for Guild Incident Actions and Incidents Data parsing by Lumabots · Pull Request #2955 · Pycord-Development/pycord

Lumabots · 2025-10-14T13:25:25Z

Summary

This PR introduces full support for Discord’s Guild Incident Actions API and Incidents Data Object as defined in the Discord API documentation.

Key Features
• Implemented IncidentsData model to represent the guild’s current incident state:
• invites_disabled_until
• dms_disabled_until
• dm_spam_detected_at
• raid_detected_at
• Added ModifyIncidentsPayload type for modifying incident restrictions via REST.

Notes
• The incidents_data field may be omitted or null for guilds without active incidents.
• This update lays the groundwork for future automation or moderation features (e.g., automated incident reporting, DM lockdowns).

Example Usage

@bot.slash_command()
async def test(ctx: discord.ApplicationContext):
    guild = ctx.guild
    if guild is None:
        await ctx.respond("This command can only be used in a guild.")
        return
    if guild.incidents_data is None:
        await ctx.respond("This guild has no incidents data.")
        return
    time = datetime.datetime.now(datetime.UTC) + datetime.timedelta(hours=1)
    updated_data = await guild.modify_incident_actions(
        invites_disabled_until=time, dms_disabled_until=None
    )
    await ctx.respond(f"Updated incidents data: {updated_data.to_dict()}")

Information

This PR fixes an issue.
This PR adds something new (e.g. new method or parameters).
This PR is a breaking change (e.g. methods or parameters removed/renamed).
This PR is not a code change (e.g. documentation, README, typehinting,
examples, ...).

Checklist

I have searched the open pull requests for duplicates.
If code changes were made then they have been tested.
- I have updated the documentation to reflect the changes.
If type: ignore comments were used, a comment is also left explaining why.
I have updated the changelog to include these changes.

pycord-app · 2025-10-14T13:25:30Z

Thanks for opening this pull request!
Please make sure you have read the Contributing Guidelines and Code of Conduct.

This pull request can be checked-out with:

git fetch origin pull/2955/head:pr-2955
git checkout pr-2955

This pull request can be installed with:

pip install git+https://github.com/Pycord-Development/pycord@refs/pull/2955/head

…into incident-actions-

Copilot

Pull Request Overview

This PR adds comprehensive support for Discord's Guild Incident Actions API, enabling automated moderation features for guilds experiencing spam or raid incidents.

Introduces IncidentsData model to represent guild incident states with timestamp fields for disabled invites/DMs and detected incidents
Adds modify_incident_actions method to the Guild class for programmatically managing incident restrictions
Implements HTTP endpoint integration for the /guilds/{guild_id}/incident-actions API route

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
discord/types/guild.py	Adds TypedDict definitions for IncidentsData and ModifyIncidents payloads
discord/incidents.py	New module containing IncidentsData class with datetime parsing and serialization
discord/http.py	Implements HTTP client method for modify_guild_incident_actions API endpoint
discord/guild.py	Integrates incidents_data attribute and modify_incident_actions method into Guild class
discord/init.py	Exports incidents module in package imports

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

discord/guild.py

discord/http.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

Copilot

Pull Request Overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

discord/guild.py

discord/incidents.py

discord/guild.py

discord/incidents.py

Co-authored-by: Soheab <33902984+Soheab@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

Copilot

Pull Request Overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

discord/incidents.py

discord/guild.py

discord/incidents.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

Copilot

Pull Request Overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

discord/http.py

discord/guild.py

Co-authored-by: Soheab <33902984+Soheab@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

Paillat-dev · 2025-10-20T11:54:41Z

@Lumabots missing copyright on incidents.py !

Lumabots · 2025-10-20T11:57:02Z

@Lumabots missing copyright on incidents.py !

I'll make a pr in a bit

Lulalaby · 2025-10-20T11:58:40Z

oop

…ng (Pycord-Development#2955) * feat: add incident management functionality to guilds * fix: remove deprecated type checking configuration for basedpyright * style(pre-commit): auto fixes from pre-commit.com hooks * fix: rename incidents attribute to incidents_data to follow api * style(pre-commit): auto fixes from pre-commit.com hooks * Update discord/http.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com> * Update discord/guild.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com> * Update discord/incidents.py Co-authored-by: Soheab <33902984+Soheab@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com> * refactor(incidents): simplify datetime parsing using parse_time utility * removal of guild * style(pre-commit): auto fixes from pre-commit.com hooks * Update discord/guild.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com> * fix(incidents): require data parameter in IncidentsData constructor * fix(guild): rename incidents attribute to incidents_data for clarity * Update guild.py Co-authored-by: Soheab <33902984+Soheab@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com> --------- Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com> Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Soheab <33902984+Soheab@users.noreply.github.com> (cherry picked from commit 0ccf2f1)

Lumabots added 2 commits October 14, 2025 16:23

feat: add incident management functionality to guilds

e5ca2d1

fix: remove deprecated type checking configuration for basedpyright

438dd0c

Lumabots requested review from a team as code owners October 14, 2025 13:25

Lumabots requested review from DA-344, JustaSqu1d, Lulalaby and NeloBlivion October 14, 2025 13:25

pullapprove4 bot added PA: All Contributors pending PA: Maintainers pending labels Oct 14, 2025

style(pre-commit): auto fixes from pre-commit.com hooks

ab78401

Lumabots changed the title ~~Incident actions~~ feat: Add support for Guild Incident Actions and Incidents Data parsing Oct 14, 2025

Lumabots and others added 3 commits October 14, 2025 16:29

fix: rename incidents attribute to incidents_data to follow api

67fdcab

Merge branch 'incident-actions-' of https://github.com/Lumabots/pycord …

bb033f6

…into incident-actions-

style(pre-commit): auto fixes from pre-commit.com hooks

9fd5c30

Lumabots requested a review from Copilot October 14, 2025 13:32

Copilot AI reviewed Oct 14, 2025

View reviewed changes

discord/guild.py Outdated Show resolved Hide resolved

discord/http.py Outdated Show resolved Hide resolved

Lumabots and others added 2 commits October 14, 2025 15:36

Update discord/http.py

f3e7c40

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

Update discord/guild.py

356c343

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

Lumabots requested a review from Copilot October 14, 2025 13:37

Copilot AI reviewed Oct 14, 2025

View reviewed changes

discord/guild.py Outdated Show resolved Hide resolved

Soheab requested changes Oct 14, 2025

View reviewed changes

discord/incidents.py Show resolved Hide resolved

discord/guild.py Outdated Show resolved Hide resolved

discord/incidents.py Outdated Show resolved Hide resolved

discord/incidents.py Outdated Show resolved Hide resolved

pullapprove4 bot removed the PA: All Contributors pending label Oct 14, 2025

Lumabots and others added 4 commits October 14, 2025 15:41

Update discord/incidents.py

f45b897

Co-authored-by: Soheab <33902984+Soheab@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

refactor(incidents): simplify datetime parsing using parse_time utility

97a14e5

removal of guild

068e2c7

style(pre-commit): auto fixes from pre-commit.com hooks

1cfa614

Lumabots requested a review from Copilot October 14, 2025 13:55

Copilot AI reviewed Oct 14, 2025

View reviewed changes

discord/incidents.py Outdated Show resolved Hide resolved

discord/guild.py Outdated Show resolved Hide resolved

discord/guild.py Show resolved Hide resolved

discord/incidents.py Outdated Show resolved Hide resolved

Lumabots and others added 2 commits October 14, 2025 15:57

Update discord/guild.py

1d160c1

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

fix(incidents): require data parameter in IncidentsData constructor

64965b3

Lumabots requested a review from Copilot October 14, 2025 14:00

Copilot AI reviewed Oct 14, 2025

View reviewed changes

discord/http.py Show resolved Hide resolved

Lumabots requested a review from Soheab October 14, 2025 14:02

pullapprove4 bot added the PA: All Contributors pending label Oct 14, 2025

Lumabots added 2 commits October 14, 2025 17:13

fix(guild): rename incidents attribute to incidents_data for clarity

475a248

Merge branch 'master' into incident-actions-

89f3b57

Soheab reviewed Oct 17, 2025

View reviewed changes

discord/guild.py Outdated Show resolved Hide resolved

pullapprove4 bot removed the PA: All Contributors pending label Oct 17, 2025

Update guild.py

c2bba6f

Co-authored-by: Soheab <33902984+Soheab@users.noreply.github.com> Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

Lumabots requested a review from Soheab October 19, 2025 09:31

pullapprove4 bot added the PA: All Contributors pending label Oct 19, 2025

Soheab approved these changes Oct 19, 2025

View reviewed changes

Paillat-dev added the hold: testing This pull request requires further testing label Oct 20, 2025

Lulalaby approved these changes Oct 20, 2025

View reviewed changes

pullapprove4 bot removed PA: All Contributors pending PA: Maintainers pending labels Oct 20, 2025

Lulalaby merged commit 0ccf2f1 into Pycord-Development:master Oct 20, 2025
28 checks passed

Uh oh!

Conversation

Lumabots commented Oct 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Information

Checklist

Uh oh!

pycord-app bot commented Oct 14, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Paillat-dev commented Oct 20, 2025

Uh oh!

Lumabots commented Oct 20, 2025

Uh oh!

Lulalaby commented Oct 20, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Lumabots commented Oct 14, 2025 •

edited

Loading