Skip to content

Latest commit

 

History

History
2404 lines (1415 loc) · 63.5 KB

enums.rst

File metadata and controls

2404 lines (1415 loc) · 63.5 KB

discord

Enumerations

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: A TextChannel or Object 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 to 1 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 to 1 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: A TextChannel or Object 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: A TextChannel or Object 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: A TextChannel or Object 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 (OnboardingPrompts) 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.