discord
The API provides some enumerations for certain types of strings to avoid the API from being stringly typed in case the strings change in the future.
All enumerations are subclasses of an internal class which mimics the behaviour of enum.Enum
.
Specifies the input type of an option.
2.0
sub_command
A slash subcommand.
sub_command_group
A slash command group.
string
A string.
integer
An integer.
boolean
A boolean.
user
A user from the current channel. This will be converted to an instance of .User
in private channels, else .Member
channel
A channel from the current guild.
role
A role from the current guild.
mentionable
A mentionable (user or role).
number
A floating number.
attachment
An attachment.
Specifies the type of channel.
text
A text channel.
voice
A voice channel.
private
A private text channel. Also called a direct message.
group
A private group text channel.
category
A category channel.
news
A guild news channel.
stage_voice
A guild stage voice channel.
1.7
news_thread
A news thread.
2.0
public_thread
A public thread.
2.0
private_thread
A private thread.
2.0
directory
A guild directory entry, used in hub guilds, currently in experiment.
2.0
forum
User can only write in threads, similar functionality to a forum.
2.0
Specifies the type of Message
. This is used to denote if a message is to be interpreted as a system message or a regular message.
x == y
Checks if two messages are equal.
x != y
Checks if two messages are not equal.
default
The default message type. This is the same as regular messages.
recipient_add
The system message when a user is added to a group private message or a thread.
recipient_remove
The system message when a user is removed from a group private message or a thread.
call
The system message denoting call state, e.g. missed call, started call, etc.
channel_name_change
The system message denoting that a channel's name has been changed.
channel_icon_change
The system message denoting that a channel's icon has been changed.
pins_add
The system message denoting that a pinned message has been added to a channel.
new_member
The system message denoting that a new member has joined a Guild.
premium_guild_subscription
The system message denoting that a member has "nitro boosted" a guild.
premium_guild_tier_1
The system message denoting that a member has "nitro boosted" a guild and it achieved level 1.
premium_guild_tier_2
The system message denoting that a member has "nitro boosted" a guild and it achieved level 2.
premium_guild_tier_3
The system message denoting that a member has "nitro boosted" a guild and it achieved level 3.
channel_follow_add
The system message denoting that an announcement channel has been followed.
1.3
guild_stream
The system message denoting that a member is streaming in the guild.
1.7
guild_discovery_disqualified
The system message denoting that the guild is no longer eligible for Server Discovery.
1.7
guild_discovery_requalified
The system message denoting that the guild has become eligible again for Server Discovery.
1.7
guild_discovery_grace_period_initial_warning
The system message denoting that the guild has failed to meet the Server Discovery requirements for one week.
1.7
guild_discovery_grace_period_final_warning
The system message denoting that the guild has failed to meet the Server Discovery requirements for 3 weeks in a row.
1.7
thread_created
The system message denoting that a thread has been created. This is only sent if the thread has been created from an older message. The period of time required for a message to be considered old cannot be relied upon and is up to Discord.
2.0
reply
The system message denoting that the author is replying to a message.
2.0
application_command
The system message denoting that an application (or "slash") command was executed.
2.0
guild_invite_reminder
The system message sent as a reminder to invite people to the guild.
2.0
thread_starter_message
The system message denoting the message in the thread that is the one that started the thread's conversation topic.
2.0
context_menu_command
The system message denoting that an context menu command was executed.
2.0
auto_moderation_action
The system message denoting an action by automod.
2.3
role_subscription_purchase
The system message denoting a role-subscription purchase.
2.4
interaction_premium_upsell
The system message denoting an interaction premium upsell.
2.4
stage_start
The system message denoting that a stage event has started.
2.4
stage_end
The system message denoting that a stage event has ended.
2.4
stage_speaker
The system message denoting that a stage event has a new speaker.
2.4
stage_raise_hand
The system message denoting that someone in a stage event is raising their hand.
2.4
stage_topic
The system message denoting that a stage event has a new topic.
2.4
guild_application_premium_subscription
The system message denoting that a member has subscribed to a guild application.
2.4
Represents Discord User flags.
staff
The user is a Discord Employee.
partner
The user is a Discord Partner.
hypesquad
The user is a HypeSquad Events member.
bug_hunter
The user is a Bug Hunter.
mfa_sms
The user has SMS recovery for Multi Factor Authentication enabled.
premium_promo_dismissed
The user has dismissed the Discord Nitro promotion.
hypesquad_bravery
The user is a HypeSquad Bravery member.
hypesquad_brilliance
The user is a HypeSquad Brilliance member.
hypesquad_balance
The user is a HypeSquad Balance member.
early_supporter
The user is an Early Supporter.
team_user
The user is a Team User.
partner_or_verification_application
Relates to partner/verification applications.
system
The user is a system user (i.e. represents Discord officially).
has_unread_urgent_messages
The user has an unread system message.
bug_hunter_level_2
The user is a Bug Hunter Level 2.
underage_deleted
The user was deleted for being underage.
verified_bot
The user is a Verified Bot.
verified_bot_developer
The user is an Early Verified Bot Developer.
discord_certified_moderator
The user is a Moderator Programs Alumni.
bot_http_interactions
The bot has set an interactions endpoint url.
spammer
The user is disabled for being a spammer.
active_developer
The user is an Active Developer.
Specifies the type of Activity
. This is used to check how to interpret the activity itself.
unknown
An unknown activity type. This should generally not happen.
playing
A "Playing" activity type.
streaming
A "Streaming" activity type.
listening
A "Listening" activity type.
watching
A "Watching" activity type.
custom
A custom activity type.
competing
A competing activity type.
1.5
Specifies the type of Interaction
.
2.0
ping
Represents Discord pinging to see if the interaction response server is alive.
application_command
Represents a slash command interaction.
component
Represents a component based interaction, i.e. using the Discord Bot UI Kit.
auto_complete
Represents a autocomplete interaction for slash commands.
modal_submit
Represents a modal based interaction.
Specifies the response type for the interaction.
2.0
pong
Pongs the interaction when given a ping.
See also InteractionResponse.pong
channel_message
Respond to the interaction with a message.
See also InteractionResponse.send_message
deferred_channel_message
Responds to the interaction with a message at a later time.
See also InteractionResponse.defer
deferred_message_update
Acknowledges the component interaction with a promise that the message will update later (though there is no need to actually update the message).
See also InteractionResponse.defer
message_update
Responds to the interaction by editing the message.
See also InteractionResponse.edit_message
auto_complete_result
Responds to the interaction by sending the autocomplete choices.
See also InteractionResponse.send_autocomplete_result
modal
Responds to the interaction by sending a modal dialog.
See also InteractionResponse.send_modal
Represents the component type of a component.
2.0
action_row
Represents the group component which holds different components in a row.
button
Represents a button component.
select
Represents a string select component.
2.3 Use ComponentType.string_select
instead.
string_select
Represents a string select component.
input_text
Represents an input_text component.
user_select
Represents a user select component.
role_select
Represents a role select component.
mentionable_select
Represents a mentionable select component.
channel_select
Represents a channel select component.
Represents the style of the button component.
2.0
primary
Represents a blurple button for the primary action.
secondary
Represents a grey button for the secondary action.
success
Represents a green button for a successful action.
danger
Represents a red button for a dangerous action.
link
Represents a link button.
blurple
An alias for primary
.
grey
An alias for secondary
.
gray
An alias for secondary
.
green
An alias for success
.
red
An alias for danger
.
url
An alias for link
.
Represents the style of the input text component.
2.0
short
Represents a single-line input text field.
long
Represents a multi-line input text field.
singleline
An alias for short
.
multiline
An alias for long
.
paragraph
An alias for long
.
Specifies the region a voice server belongs to.
amsterdam
The Amsterdam region.
brazil
The Brazil region.
dubai
The Dubai region.
1.3
eu_central
The EU Central region.
eu_west
The EU West region.
europe
The Europe region.
1.3
frankfurt
The Frankfurt region.
hongkong
The Hong Kong region.
india
The India region.
1.2
japan
The Japan region.
london
The London region.
russia
The Russia region.
singapore
The Singapore region.
southafrica
The South Africa region.
south_korea
The South Korea region.
sydney
The Sydney region.
us_central
The US Central region.
us_east
The US East region.
us_south
The US South region.
us_west
The US West region.
vip_amsterdam
The Amsterdam region for VIP guilds.
vip_us_east
The US East region for VIP guilds.
vip_us_west
The US West region for VIP guilds.
Specifies a Guild
's verification level, which is the criteria in which a member must meet before being able to send messages to the guild.
2.0
x == y
Checks if two verification levels are equal.
x != y
Checks if two verification levels are not equal.
x > y
Checks if a verification level is higher than another.
x < y
Checks if a verification level is lower than another.
x >= y
Checks if a verification level is higher or equal to another.
x <= y
Checks if a verification level is lower or equal to another.
none
No criteria set.
low
Member must have a verified email on their Discord account.
medium
Member must have a verified email and be registered on Discord for more than five minutes.
high
Member must have a verified email, be registered on Discord for more than five minutes, and be a member of the guild itself for more than ten minutes.
highest
Member must have a verified phone on their Discord account.
Specifies whether a Guild
has notifications on for all messages or mentions only by default.
2.0
x == y
Checks if two notification levels are equal.
x != y
Checks if two notification levels are not equal.
x > y
Checks if a notification level is higher than another.
x < y
Checks if a notification level is lower than another.
x >= y
Checks if a notification level is higher or equal to another.
x <= y
Checks if a notification level is lower or equal to another.
all_messages
Members receive notifications for every message regardless of them being mentioned.
only_mentions
Members receive notifications for messages they are mentioned in.
Specifies a Guild
's explicit content filter, which is the machine learning algorithms that Discord uses to detect if an image contains pornography or otherwise explicit content.
2.0
x == y
Checks if two content filter levels are equal.
x != y
Checks if two content filter levels are not equal.
x > y
Checks if a content filter level is higher than another.
x < y
Checks if a content filter level is lower than another.
x >= y
Checks if a content filter level is higher or equal to another.
x <= y
Checks if a content filter level is lower or equal to another.
disabled
The guild does not have the content filter enabled.
no_role
The guild has the content filter enabled for members without a role.
all_members
The guild has the content filter enabled for every member.
Specifies a Member
's status.
online
The member is online.
offline
The member is offline.
idle
The member is idle.
dnd
The member is "Do Not Disturb".
do_not_disturb
An alias for dnd
.
invisible
The member is "invisible". In reality, this is only used in sending a presence a la Client.change_presence
. When you receive a user's presence this will be offline
instead.
streaming
The member is streaming.
Represents the type of action being done for a AuditLogEntry
, which is retrievable via Guild.audit_logs
.
guild_update
The guild has updated. Things that trigger this include:
- Changing the guild vanity URL
- Changing the guild invite splash
- Changing the guild AFK channel or timeout
- Changing the guild voice server region
- Changing the guild icon, banner, or discovery splash
- Changing the guild moderation settings
- Changing things related to the guild widget
When this is the action, the type of ~AuditLogEntry.target
is the Guild
.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.afk_channel
~AuditLogDiff.system_channel
~AuditLogDiff.afk_timeout
~AuditLogDiff.default_message_notifications
~AuditLogDiff.explicit_content_filter
~AuditLogDiff.mfa_level
~AuditLogDiff.name
~AuditLogDiff.owner
~AuditLogDiff.splash
~AuditLogDiff.discovery_splash
~AuditLogDiff.icon
~AuditLogDiff.banner
~AuditLogDiff.vanity_url_code
channel_create
A new channel was created.
When this is the action, the type of ~AuditLogEntry.target
is either a abc.GuildChannel
or Object
with an ID.
A more filled out object in the Object
case can be found by using ~AuditLogEntry.after
.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.type
~AuditLogDiff.overwrites
channel_update
A channel was updated. Things that trigger this include:
- The channel name or topic was changed
- The channel bitrate was changed
When this is the action, the type of ~AuditLogEntry.target
is the abc.GuildChannel
or Object
with an ID.
A more filled out object in the Object
case can be found by using ~AuditLogEntry.after
or ~AuditLogEntry.before
.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.type
~AuditLogDiff.position
~AuditLogDiff.overwrites
~AuditLogDiff.topic
~AuditLogDiff.bitrate
~AuditLogDiff.rtc_region
~AuditLogDiff.video_quality_mode
~AuditLogDiff.default_auto_archive_duration
channel_delete
A channel was deleted.
When this is the action, the type of ~AuditLogEntry.target
is an Object
with an ID.
A more filled out object can be found by using the ~AuditLogEntry.before
object.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.type
~AuditLogDiff.overwrites
overwrite_create
A channel permission overwrite was created.
When this is the action, the type of ~AuditLogEntry.target
is the abc.GuildChannel
or Object
with an ID.
When this is the action, the type of ~AuditLogEntry.extra
is either a Role
or Member
. If the object is not found then it is a Object
with an ID being filled, a name, and a type
attribute set to either 'role'
or 'member'
to help dictate what type of ID it is.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.deny
~AuditLogDiff.allow
~AuditLogDiff.id
~AuditLogDiff.type
overwrite_update
A channel permission overwrite was changed, this is typically when the permission values change.
See overwrite_create
for more information on how the ~AuditLogEntry.target
and ~AuditLogEntry.extra
fields are set.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.deny
~AuditLogDiff.allow
~AuditLogDiff.id
~AuditLogDiff.type
overwrite_delete
A channel permission overwrite was deleted.
See overwrite_create
for more information on how the ~AuditLogEntry.target
and ~AuditLogEntry.extra
fields are set.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.deny
~AuditLogDiff.allow
~AuditLogDiff.id
~AuditLogDiff.type
kick
A member was kicked.
When this is the action, the type of ~AuditLogEntry.target
is the User
who got kicked.
When this is the action, ~AuditLogEntry.changes
is empty.
member_prune
A member prune was triggered.
When this is the action, the type of ~AuditLogEntry.target
is set to None
.
When this is the action, the type of ~AuditLogEntry.extra
is set to an unspecified proxy object with two attributes:
delete_members_days
: An integer specifying how far the prune was.members_removed
: An integer specifying how many members were removed.
When this is the action, ~AuditLogEntry.changes
is empty.
ban
A member was banned.
When this is the action, the type of ~AuditLogEntry.target
is the User
who got banned.
When this is the action, ~AuditLogEntry.changes
is empty.
unban
A member was unbanned.
When this is the action, the type of ~AuditLogEntry.target
is the User
who got unbanned.
When this is the action, ~AuditLogEntry.changes
is empty.
member_update
A member has updated. This triggers in the following situations:
- A nickname was changed
- They were server muted or deafened (or it was undone)
When this is the action, the type of ~AuditLogEntry.target
is the Member
or User
who got updated.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.nick
~AuditLogDiff.mute
~AuditLogDiff.deaf
member_role_update
A member's role has been updated. This triggers when a member either gains a role or loses a role.
When this is the action, the type of ~AuditLogEntry.target
is the Member
or User
who got the role.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.roles
member_move
A member's voice channel has been updated. This triggers when a member is moved to a different voice channel.
When this is the action, the type of ~AuditLogEntry.extra
is set to an unspecified proxy object with two attributes:
channel
: ATextChannel
orObject
with the channel ID where the members were moved.count
: An integer specifying how many members were moved.
1.3
member_disconnect
A member's voice state has changed. This triggers when a member is force disconnected from voice.
When this is the action, the type of ~AuditLogEntry.extra
is set to an unspecified proxy object with one attribute:
count
: An integer specifying how many members were disconnected.
1.3
bot_add
A bot was added to the guild.
When this is the action, the type of ~AuditLogEntry.target
is the Member
or User
which was added to the guild.
1.3
role_create
A new role was created.
When this is the action, the type of ~AuditLogEntry.target
is the Role
or a Object
with the ID.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.colour
~AuditLogDiff.mentionable
~AuditLogDiff.hoist
~AuditLogDiff.name
~AuditLogDiff.permissions
role_update
A role was updated. This triggers in the following situations:
- The name has changed
- The permissions have changed
- The colour has changed
- Its hoist/mentionable state has changed
When this is the action, the type of ~AuditLogEntry.target
is the Role
or a Object
with the ID.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.colour
~AuditLogDiff.mentionable
~AuditLogDiff.hoist
~AuditLogDiff.name
~AuditLogDiff.permissions
role_delete
A role was deleted.
When this is the action, the type of ~AuditLogEntry.target
is the Role
or a Object
with the ID.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.colour
~AuditLogDiff.mentionable
~AuditLogDiff.hoist
~AuditLogDiff.name
~AuditLogDiff.permissions
invite_create
An invite was created.
When this is the action, the type of ~AuditLogEntry.target
is the Invite
that was created.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.max_age
~AuditLogDiff.code
~AuditLogDiff.temporary
~AuditLogDiff.inviter
~AuditLogDiff.channel
~AuditLogDiff.uses
~AuditLogDiff.max_uses
invite_update
An invite was updated.
When this is the action, the type of ~AuditLogEntry.target
is the Invite
that was updated.
invite_delete
An invite was deleted.
When this is the action, the type of ~AuditLogEntry.target
is the Invite
that was deleted.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.max_age
~AuditLogDiff.code
~AuditLogDiff.temporary
~AuditLogDiff.inviter
~AuditLogDiff.channel
~AuditLogDiff.uses
~AuditLogDiff.max_uses
webhook_create
A webhook was created.
When this is the action, the type of ~AuditLogEntry.target
is the Object
with the webhook ID.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.channel
~AuditLogDiff.name
~AuditLogDiff.type
(always set to1
if so)
webhook_update
A webhook was updated. This trigger in the following situations:
- The webhook name changed
- The webhook channel changed
When this is the action, the type of ~AuditLogEntry.target
is the Object
with the webhook ID.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.channel
~AuditLogDiff.name
~AuditLogDiff.avatar
webhook_delete
A webhook was deleted.
When this is the action, the type of ~AuditLogEntry.target
is the Object
with the webhook ID.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.channel
~AuditLogDiff.name
~AuditLogDiff.type
(always set to1
if so)
emoji_create
An emoji was created.
When this is the action, the type of ~AuditLogEntry.target
is the Emoji
or Object
with the emoji ID.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
emoji_update
An emoji was updated. This triggers when the name has changed.
When this is the action, the type of ~AuditLogEntry.target
is the Emoji
or Object
with the emoji ID.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
emoji_delete
An emoji was deleted.
When this is the action, the type of ~AuditLogEntry.target
is the Object
with the emoji ID.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
message_delete
A message was deleted by a moderator. Note that this only triggers if the message was deleted by someone other than the author.
When this is the action, the type of ~AuditLogEntry.target
is the Member
or User
who had their message deleted.
When this is the action, the type of ~AuditLogEntry.extra
is set to an unspecified proxy object with two attributes:
count
: An integer specifying how many messages were deleted.channel
: ATextChannel
orObject
with the channel ID where the message got deleted.
message_bulk_delete
Messages were bulk deleted by a moderator.
When this is the action, the type of ~AuditLogEntry.target
is the TextChannel
or Object
with the ID of the channel that was purged.
When this is the action, the type of ~AuditLogEntry.extra
is set to an unspecified proxy object with one attribute:
count
: An integer specifying how many messages were deleted.
1.3
message_pin
A message was pinned in a channel.
When this is the action, the type of ~AuditLogEntry.target
is the Member
or User
who had their message pinned.
When this is the action, the type of ~AuditLogEntry.extra
is set to an unspecified proxy object with two attributes:
channel
: ATextChannel
orObject
with the channel ID where the message was pinned.message_id
: the ID of the message which was pinned.
1.3
message_unpin
A message was unpinned in a channel.
When this is the action, the type of ~AuditLogEntry.target
is the Member
or User
who had their message unpinned.
When this is the action, the type of ~AuditLogEntry.extra
is set to an unspecified proxy object with two attributes:
channel
: ATextChannel
orObject
with the channel ID where the message was unpinned.message_id
: the ID of the message which was unpinned.
1.3
integration_create
A guild integration was created.
When this is the action, the type of ~AuditLogEntry.target
is the Object
with the integration ID of the integration which was created.
1.3
integration_update
A guild integration was updated.
When this is the action, the type of ~AuditLogEntry.target
is the Object
with the integration ID of the integration which was updated.
1.3
integration_delete
A guild integration was deleted.
When this is the action, the type of ~AuditLogEntry.target
is the Object
with the integration ID of the integration which was deleted.
1.3
stage_instance_create
A stage instance was started.
When this is the action, the type of ~AuditLogEntry.target
is the StageInstance
or Object
with the ID of the stage instance which was created.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.topic
~AuditLogDiff.privacy_level
2.0
stage_instance_update
A stage instance was updated.
When this is the action, the type of ~AuditLogEntry.target
is the StageInstance
or Object
with the ID of the stage instance which was updated.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.topic
~AuditLogDiff.privacy_level
2.0
stage_instance_delete
A stage instance was ended.
2.0
sticker_create
A sticker was created.
When this is the action, the type of ~AuditLogEntry.target
is the GuildSticker
or Object
with the ID of the sticker which was updated.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.emoji
~AuditLogDiff.type
~AuditLogDiff.format_type
~AuditLogDiff.description
~AuditLogDiff.available
2.0
sticker_update
A sticker was updated.
When this is the action, the type of ~AuditLogEntry.target
is the GuildSticker
or Object
with the ID of the sticker which was updated.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.emoji
~AuditLogDiff.type
~AuditLogDiff.format_type
~AuditLogDiff.description
~AuditLogDiff.available
2.0
sticker_delete
A sticker was deleted.
When this is the action, the type of ~AuditLogEntry.target
is the GuildSticker
or Object
with the ID of the sticker which was updated.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.emoji
~AuditLogDiff.type
~AuditLogDiff.format_type
~AuditLogDiff.description
~AuditLogDiff.available
2.0
scheduled_event_create
A scheduled event was created.
When this is the action, the type of ~AuditLogEntry.target
is the ScheduledEvent
or Object
with the ID of the thread which was deleted.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.description
~AuditLogDiff.channel
~AuditLogDiff.privacy_level
~discord.ScheduledEvent.location
~discord.ScheduledEvent.status
~discord.ScheduledEventLocation.type
2.0
scheduled_event_update
A scheduled event was updated.
When this is the action, the type of ~AuditLogEntry.target
is the ScheduledEvent
or Object
with the ID of the thread which was deleted.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.description
~AuditLogDiff.channel
~AuditLogDiff.privacy_level
~discord.ScheduledEvent.location
~discord.ScheduledEvent.status
~discord.ScheduledEventLocation.type
2.0
scheduled_event_delete
A scheduled event was deleted.
When this is the action, the type of ~AuditLogEntry.target
is the ScheduledEvent
or Object
with the ID of the thread which was deleted.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.description
~AuditLogDiff.channel
~AuditLogDiff.privacy_level
~discord.ScheduledEvent.location
~discord.ScheduledEvent.status
~discord.ScheduledEventLocation.type
2.0
thread_create
A thread was created.
When this is the action, the type of ~AuditLogEntry.target
is the Thread
or Object
with the ID of the thread which was created.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.archived
~AuditLogDiff.locked
~AuditLogDiff.auto_archive_duration
~AuditLogDiff.invitable
2.0
thread_update
A thread was updated.
When this is the action, the type of ~AuditLogEntry.target
is the Thread
or Object
with the ID of the thread which was updated.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.archived
~AuditLogDiff.locked
~AuditLogDiff.auto_archive_duration
~AuditLogDiff.invitable
2.0
thread_delete
A thread was deleted.
When this is the action, the type of ~AuditLogEntry.target
is the Thread
or Object
with the ID of the thread which was deleted.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.archived
~AuditLogDiff.locked
~AuditLogDiff.auto_archive_duration
~AuditLogDiff.invitable
2.0
application_command_permission_update
An application command's permissions were updated.
When this is the action, the type of ~AuditLogEntry.target
is an Object
with the ID of the command that had it's permissions edited.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.command_id
2.0
auto_moderation_rule_create
A guild auto moderation rule was created.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.enabled
~AuditLogDiff.trigger_type
~AuditLogDiff.event_type
~AuditLogDiff.trigger_metadata
~AuditLogDiff.actions
~AuditLogDiff.exempt_roles
~AuditLogDiff.exempt_channels
2.5
auto_moderation_rule_update
A guild auto moderation rule was updated.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.enabled
~AuditLogDiff.trigger_type
~AuditLogDiff.trigger_metadata
~AuditLogDiff.actions
~AuditLogDiff.exempt_roles
~AuditLogDiff.exempt_channels
2.5
auto_moderation_rule_delete
A guild auto moderation rule was deleted.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.name
~AuditLogDiff.enabled
~AuditLogDiff.trigger_type
~AuditLogDiff.event_type
~AuditLogDiff.trigger_metadata
~AuditLogDiff.actions
~AuditLogDiff.exempt_roles
~AuditLogDiff.exempt_channels
2.5
auto_moderation_block_message
A message was blocked by auto moderation.
2.5
auto_moderation_flag_to_channel
A message was flagged by auto moderation.
2.5
auto_moderation_user_communication_disabled
A member was timed out by auto moderation.
2.5
creator_monetization_request_created
A creator monetization request was created.
2.5
creator_monetization_terms_accepted
The creator monetization terms were accepted.
2.5
voice_channel_status_update
A voice channel status was updated.
When this is the action, the type of ~AuditLogEntry.target
is the VoiceChannel
or Object
with the ID of the voice channel which was updated.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.status
2.5
voice_channel_status_delete
A voice channel status was deleted.
When this is the action, the type of ~AuditLogEntry.target
is the VoiceChannel
or Object
with the ID of the voice channel which was updated.
Possible attributes for AuditLogDiff
:
~AuditLogDiff.status
2.5
Represents the category that the AuditLogAction
belongs to.
This can be retrieved via AuditLogEntry.category
.
create
The action is the creation of something.
delete
The action is the deletion of something.
update
The action is the update of something.
Represents the membership state of a team member retrieved through Client.application_info
.
1.3
invited
Represents an invited member.
accepted
Represents a member currently in the team.
Represents the type of webhook that can be received.
1.3
incoming
Represents a webhook that can post messages to channels with a token.
channel_follower
Represents a webhook that is internally managed by Discord, used for following channels.
application
Represents a webhook that is used for interactions or applications.
2.0
Represents the behaviour the Integration
should perform when a user's subscription has finished.
There is an alias for this called ExpireBehavior
.
1.4
remove_role
This will remove the StreamIntegration.role
from the user when their subscription is finished.
kick
This will kick the user when their subscription is finished.
Represents the default avatar of a Discord User
blurple
Represents the default avatar with the color blurple. See also Colour.blurple
grey
Represents the default avatar with the color grey. See also Colour.greyple
gray
An alias for grey
.
green
Represents the default avatar with the color green. See also Colour.green
orange
Represents the default avatar with the color orange. See also Colour.orange
red
Represents the default avatar with the color red. See also Colour.red
Represents the type of sticker.
2.0
standard
Represents a standard sticker that all Nitro users can use.
guild
Represents a custom sticker created in a guild.
Represents the type of sticker images.
1.6
png
Represents a sticker with a png image.
apng
Represents a sticker with an apng image.
lottie
Represents a sticker with a lottie image.
gif
Represents a sticker with a gif image.
2.4
Represents the invite type for voice channel invites.
2.0
unknown
The invite doesn't target anyone or anything.
stream
A stream invite that targets a user.
embedded_application
A invite that targets an embedded application.
Note that your bot won't be verified if you provide users access to this
Represents the camera video quality mode for voice channel participants.
2.0
auto
Represents auto camera video quality.
full
Represents full camera video quality.
Represents a stage instance's privacy level. Stage event privacy levels can only have 1 possible value at the moment so this shouldn't really be used.
2.0
closed
The stage instance can only be joined by members of the guild.
guild_only
Alias for .closed
Represents the NSFW level of a guild.
2.0
x == y
Checks if two NSFW levels are equal.
x != y
Checks if two NSFW levels are not equal.
x > y
Checks if a NSFW level is higher than another.
x < y
Checks if a NSFW level is lower than another.
x >= y
Checks if a NSFW level is higher or equal to another.
x <= y
Checks if a NSFW level is lower or equal to another.
default
The guild has not been categorised yet.
explicit
The guild contains NSFW content.
safe
The guild does not contain any NSFW content.
age_restricted
The guild may contain NSFW content.
Represents an embedded activity application.
Some might be boost-only or gated.
Warning
Discord said that they won't verify bots who gives access to embedded activities.
Read more here: https://discord.com/channels/613425648685547541/697236247739105340/901153332075315321.
2.0
ask_away
Represents the embedded application Ask Away.
2.4
awkword
Represents the embedded application Awkword.
Warning
This activity has been removed.
awkword_dev
Development version of .awkword
.
Warning
This activity has been removed.
bash_out
Represents the embedded application Bash Out.
2.4
betrayal
Represents the embedded application Betrayal.io.
blazing_8s
Represents the embedded application Blazing 8s.
2.4
blazing_8s_dev
Development version of .blazing_8s
.
2.4
blazing_8s_qa
QA version of .blazing_8s
.
2.4
blazing_8s_staging
Staging version of .blazing_8s
.
2.4
bobble_league
Represents the embedded application Bobble League.
2.4
checkers_in_the_park
Represents the embedded application Checkers in the Park.
checkers_in_the_park_dev
Development version of .checkers_in_the_park
.
checkers_in_the_park_qa
QA version of .checkers_in_the_park
.
checkers_in_the_park_staging
Staging version of .checkers_in_the_park
.
chess_in_the_park
Represents the embedded application Chess in the Park.
chess_in_the_park_dev
Development version of .chess_in_the_park
.
chess_in_the_park_qa
QA version of .chess_in_the_park
.
chess_in_the_park_staging
Staging version of .chess_in_the_park
.
decoders_dev
Represents the embedded application Decoders Development.
Warning
This activity has been removed.
doodle_crew
Represents the embedded application Doodle Crew.
Warning
This activity has been removed.
doodle_crew_dev
Development version of .doodle_crew
.
Warning
This activity has been removed.
fishington
Represents the embedded application Fishington.io.
gartic_phone
Represents the embedded application Gartic Phone.
2.5
jamspace
Represents the embedded application Jamspace.
2.5
know_what_i_meme
Represents the embedded application Know What I Meme.
2.4
land
Represents the embedded application Land.io.
2.4
letter_league
Represents the embedded application Letter League.
letter_league_dev
Development version of .letter_league
.
2.4
poker_night
Represents the embedded application Poker Night.
poker_night_dev
Development version of .poker_night
.
2.4
poker_night_qa
QA version of .poker_night
.
poker_night_staging
Staging version of .poker_night
.
putt_party
Represents the embedded application Putt Party.
2.4
putt_party_dev
Development version of .putt_party
.
2.4
putt_party_qa
QA version of .putt_party
.
2.4
putt_party_staging
Staging version of .putt_party
.
2.4
putts
Represents the embedded application Putts.
Warning
This activity has been removed.
sketch_heads
Represents the embedded application Sketch Heads.
2.4
sketch_heads_dev
Development version of .sketch_heads
.
2.4
sketchy_artist
Represents the embedded application Sketchy Artist.
Warning
This activity has been removed.
sketchy_artist_dev
Development version of .sketchy_artist
.
Warning
This activity has been removed.
spell_cast
Represents the embedded application Spell Cast.
spell_cast_staging
Staging version of .spell_cast
.
2.4
watch_together
Same as ~EmbeddedActivity.youtube_together
with remote feature which allows guild admins to limit the playlist access.
watch_together_dev
Development version of .watch_together
.
word_snacks
Represents the embedded application word snacks.
word_snacks_dev
Development version of .word_snacks
.
youtube_together
Represents the embedded application Youtube Together.
Represents the status of a scheduled event.
2.0
scheduled
The scheduled event hasn't started or been canceled yet.
active
The scheduled event is in progress.
completed
The scheduled event is over.
canceled
The scheduled event has been canceled before it can start.
cancelled
Alias to canceled
.
Represents a scheduled event location type (otherwise known as the entity type on the API).
2.0
stage_instance
Represents a scheduled event that is happening in a StageChannel
.
voice
Represents a scheduled event that is happening in a VoiceChannel
.
external
Represents a generic location as a str
.
Represents the privacy level of a scheduled event. Scheduled event privacy levels can only have 1 possible value at the moment so this shouldn't really be used.
guild_only
Represents a scheduled event that is only available to members inside the guild.
Represents an application role connection metadata type.
Each metadata type offers a comparison operation that allows guilds to configure role requirements based on metadata values stored by the bot. Bots specify a metadata value
for each user and guilds specify the required guild's configured value
within the guild role settings.
2.4
integer_less_than_or_equal
The metadata value (integer
) is less than or equal to the guild's configured value (integer
).
integer_greater_than_or_equal
The metadata value (integer
) is greater than or equal to the guild's configured value (integer
).
integer_equal
The metadata value (integer
) is equal to the guild's configured value (integer
).
integer_not_equal
The metadata value (integer
) is not equal to the guild's configured value (integer
).
datetime_less_than_or_equal
The metadata value (datetime
) is less than or equal to the guild's configured value (integer
; the number of days before the current date).
datetime_greater_than_or_equal
The metadata value (datetime
) is greater than or equal to the guild's configured value (integer
; the number of days before the current date).
boolean_equal
The metadata value (integer
) is equal to the guild's configured value (integer
; 1).
boolean_not_equal
The metadata value (integer
) is not equal to the guild's configured value (integer
; 1).
Represents an AutoMod trigger type.
2.0
keyword
Represents a keyword rule trigger, which are customizable by a guild.
Possible attributes for AutoModTriggerMetadata
:
~AutoModTriggerMetadata.keyword_filter
~AutoModTriggerMetadata.regex_patterns
~AutoModTriggerMetadata.allow_list
keyword_preset
Represents a preset keyword rule trigger.
Possible attributes for AutoModTriggerMetadata
:
~AutoModTriggerMetadata.presets
~AutoModTriggerMetadata.allow_list
spam
Represents the spam rule trigger.
There are no possible attributes for AutoModTriggerMetadata
.
mention_spam
Represents a mention spam keyword rule trigger.
Possible attributes for AutoModTriggerMetadata
:
~AutoModTriggerMetadata.mention_total_limit
2.4
harmful_link
Represents a harmful link rule trigger.
2.4 Removed by Discord and merged into spam
.
Represents an AutoMod event type.
2.0
message_send
Represents a message send AutoMod event.
Represents the type of action AutoMod is performing.
2.0
block_message
Represents a block message action.
send_alert_message
Represents a send alert message action.
timeout
Represents a timeout action.
Represents an AutoMod keyword preset type.
2.0
profanity
Represents the profanity keyword preset rule.
sexual_content
Represents the sexual content keyword preset rule.
slurs
Represents the slurs keyword preset rule.
Represents how each prompt's options are displayed.
2.5
multiple_choice
The options will appear in a grid form, showing the name and description.
dropdown
The options will appear in a dropdown (similar to select menus), but without the description displayed. This is enforced if there are more than 12 options in the prompt.
Represents the current mode of the guild's onboarding flow.
2.5
default
Only default channels are counted towards the Onboarding requirements.
advanced
Both default channels and questions (OnboardingPrompt
s) will count towards the Onboarding requirements.
Represents a Reaction's type.
2.5
normal
Represents a normal reaction.
burst
Represents a super reaction.
Represents an SKU's type.
2.5
subscription
Represents a recurring subscription.
subscription_group
A system-generated group for each subscription SKU created. These types of SKUs are currently unused.
Represents an entitlement's type.
2.5
app_subscription
Entitlement was purchased as an app subscription.
Represents an entitlement's ownership type.
2.5
guild
Entitlement is owned by a guild.
user
Entitlement is owned by a user.