.. currentmodule:: discord
The following section outlines the API of Pycord.
Note
This module uses the Python logging module to log diagnostic and errors in an output independent way. If the logging module is not configured, these logs will not be output anywhere. See :ref:`logging_setup` for more information on how to set up and use the logging module with Pycord.
There are two main ways to query version information about the library. For guarantees, check :ref:`version_guarantees`.
.. data:: version_info
A named tuple that is similar to :obj:`py:sys.version_info`.
Just like :obj:`py:sys.version_info` the valid values for ``releaselevel`` are
'alpha', 'beta', 'candidate' and 'final'.
.. data:: __version__
A string representation of the version. e.g. ``'1.0.0rc1'``. This is based
off of :pep:`440`.
.. attributetable:: Client
.. autoclass:: Client
:members:
:exclude-members: fetch_guilds, event
.. automethod:: Client.event()
:decorator:
.. automethod:: Client.fetch_guilds
:async-for:
.. attributetable:: AutoShardedClient
.. autoclass:: AutoShardedClient
:members:
.. attributetable:: Bot
.. autoclass:: Bot
:members:
:inherited-members:
:exclude-members: command, event, message_command, slash_command, user_command, listen
.. automethod:: Bot.command(**kwargs)
:decorator:
.. automethod:: Bot.event()
:decorator:
.. automethod:: Bot.message_command(**kwargs)
:decorator:
.. automethod:: Bot.slash_command(**kwargs)
:decorator:
.. automethod:: Bot.user_command(**kwargs)
:decorator:
.. automethod:: Bot.listen(name=None)
:decorator:
.. attributetable:: AutoShardedBot
.. autoclass:: AutoShardedBot
:members:
.. autofunction:: discord.commands.default_permissions
:decorator:
.. autofunction:: discord.commands.guild_only
:decorator:
.. attributetable:: ApplicationCommand
.. autoclass:: ApplicationCommand
:members:
.. autofunction:: discord.commands.application_command
:decorator:
.. autofunction:: discord.commands.command
:decorator:
.. attributetable:: SlashCommand
.. autoclass:: SlashCommand
:members:
.. autofunction:: discord.commands.slash_command
:decorator:
.. attributetable:: SlashCommandGroup
.. autoclass:: SlashCommandGroup
:members:
.. attributetable:: Option
.. autoclass:: Option
:members:
.. autofunction:: discord.commands.Option
:decorator:
.. attributetable:: ThreadOption
.. autoclass:: ThreadOption
:members:
.. attributetable:: OptionChoice
.. autoclass:: OptionChoice
:members:
.. attributetable:: UserCommand
.. autoclass:: UserCommand
:members:
.. autofunction:: discord.commands.user_command
:decorator:
.. attributetable:: MessageCommand
.. autoclass:: MessageCommand
:members:
.. autofunction:: discord.commands.message_command
:decorator:
.. attributetable:: ApplicationContext
.. autoclass:: ApplicationContext
:members:
.. attributetable:: AutocompleteContext
.. autoclass:: AutocompleteContext
:members:
.. attributetable:: Cog
.. autoclass:: Cog
:members:
.. attributetable:: CogMeta
.. autoclass:: CogMeta
:members:
.. attributetable:: AppInfo
.. autoclass:: AppInfo()
:members:
.. attributetable:: PartialAppInfo
.. autoclass:: PartialAppInfo()
:members:
.. attributetable:: Team
.. autoclass:: Team()
:members:
.. attributetable:: TeamMember
.. autoclass:: TeamMember()
:members:
.. attributetable:: VoiceClient
.. autoclass:: VoiceClient()
:members:
:exclude-members: connect, on_voice_state_update, on_voice_server_update
.. attributetable:: VoiceProtocol
.. autoclass:: VoiceProtocol
:members:
.. attributetable:: AudioSource
.. autoclass:: AudioSource
:members:
.. attributetable:: PCMAudio
.. autoclass:: PCMAudio
:members:
.. attributetable:: FFmpegAudio
.. autoclass:: FFmpegAudio
:members:
.. attributetable:: FFmpegPCMAudio
.. autoclass:: FFmpegPCMAudio
:members:
.. attributetable:: FFmpegOpusAudio
.. autoclass:: FFmpegOpusAudio
:members:
.. attributetable:: PCMVolumeTransformer
.. autoclass:: PCMVolumeTransformer
:members:
.. autofunction:: discord.opus.load_opus
.. autofunction:: discord.opus.is_loaded
This section outlines the different types of events listened by :class:`Client`.
There are two ways to register an event, the first way is through the use of :meth:`Client.event`. The second way is through subclassing :class:`Client` and overriding the specific events. For example:
import discord
class MyClient(discord.Client):
async def on_message(self, message):
if message.author == self.user:
return
if message.content.startswith('$hello'):
await message.channel.send('Hello World!')
If an event handler raises an exception, :func:`on_error` will be called to handle it, which defaults to print a traceback and ignoring the exception.
Warning
All the events must be a |coroutine_link|_. If they aren't, then you might get unexpected
errors. In order to turn a function into a coroutine they must be async def
functions.
.. function:: on_connect()
Called when the client has successfully connected to Discord. This is not
the same as the client being fully prepared, see :func:`on_ready` for that.
The warnings on :func:`on_ready` also apply.
.. function:: on_shard_connect(shard_id)
Similar to :func:`on_connect` except used by :class:`AutoShardedClient`
to denote when a particular shard ID has connected to Discord.
.. versionadded:: 1.4
:param shard_id: The shard ID that has connected.
:type shard_id: :class:`int`
.. function:: on_disconnect()
Called when the client has disconnected from Discord, or a connection attempt to Discord has failed.
This could happen either through the internet being disconnected, explicit calls to close,
or Discord terminating the connection one way or the other.
This function can be called many times without a corresponding :func:`on_connect` call.
.. function:: on_shard_disconnect(shard_id)
Similar to :func:`on_disconnect` except used by :class:`AutoShardedClient`
to denote when a particular shard ID has disconnected from Discord.
.. versionadded:: 1.4
:param shard_id: The shard ID that has disconnected.
:type shard_id: :class:`int`
.. function:: on_ready()
Called when the client is done preparing the data received from Discord. Usually after login is successful
and the :attr:`Client.guilds` and co. are filled up.
.. warning::
This function is not guaranteed to be the first event called.
Likewise, this function is **not** guaranteed to only be called
once. This library implements reconnection logic and thus will
end up calling this event whenever a RESUME request fails.
.. function:: on_shard_ready(shard_id)
Similar to :func:`on_ready` except used by :class:`AutoShardedClient`
to denote when a particular shard ID has become ready.
:param shard_id: The shard ID that is ready.
:type shard_id: :class:`int`
.. function:: on_resumed()
Called when the client has resumed a session.
.. function:: on_shard_resumed(shard_id)
Similar to :func:`on_resumed` except used by :class:`AutoShardedClient`
to denote when a particular shard ID has resumed a session.
.. versionadded:: 1.4
:param shard_id: The shard ID that has resumed.
:type shard_id: :class:`int`
.. function:: on_error(event, *args, **kwargs)
Usually when an event raises an uncaught exception, a traceback is
printed to stderr and the exception is ignored. If you want to
change this behaviour and handle the exception for whatever reason
yourself, this event can be overridden. Which, when done, will
suppress the default action of printing the traceback.
The information of the exception raised and the exception itself can
be retrieved with a standard call to :func:`sys.exc_info`.
If you want exception to propagate out of the :class:`Client` class
you can define an ``on_error`` handler consisting of a single empty
:ref:`raise statement <py:raise>`. Exceptions raised by ``on_error`` will not be
handled in any way by :class:`Client`.
.. note::
``on_error`` will only be dispatched to :meth:`Client.event`.
It will not be received by :meth:`Client.wait_for`, or, if used,
:ref:`ext_commands_api_bot` listeners such as
:meth:`~ext.commands.Bot.listen` or :meth:`~ext.commands.Cog.listener`.
:param event: The name of the event that raised the exception.
:type event: :class:`str`
:param args: The positional arguments for the event that raised the
exception.
:param kwargs: The keyword arguments for the event that raised the
exception.
.. function:: on_socket_event_type(event_type)
Called whenever a websocket event is received from the WebSocket.
This is mainly useful for logging how many events you are receiving
from the Discord gateway.
.. versionadded:: 2.0
:param event_type: The event type from Discord that is received, e.g. ``'READY'``.
:type event_type: :class:`str`
.. function:: on_socket_raw_receive(msg)
Called whenever a message is completely received from the WebSocket, before
it's processed and parsed. This event is always dispatched when a
complete message is received and the passed data is not parsed in any way.
This is only really useful for grabbing the WebSocket stream and
debugging purposes.
This requires setting the ``enable_debug_events`` setting in the :class:`Client`.
.. note::
This is only for the messages received from the client
WebSocket. The voice WebSocket will not trigger this event.
:param msg: The message passed in from the WebSocket library.
:type msg: :class:`str`
.. function:: on_socket_raw_send(payload)
Called whenever a send operation is done on the WebSocket before the
message is sent. The passed parameter is the message that is being
sent to the WebSocket.
This is only really useful for grabbing the WebSocket stream and
debugging purposes.
This requires setting the ``enable_debug_events`` setting in the :class:`Client`.
.. note::
This is only for the messages sent from the client
WebSocket. The voice WebSocket will not trigger this event.
:param payload: The message that is about to be passed on to the
WebSocket library. It can be :class:`bytes` to denote a binary
message or :class:`str` to denote a regular text message.
.. function:: on_typing(channel, user, when)
Called when someone begins typing a message.
The ``channel`` parameter can be a :class:`abc.Messageable` instance.
Which could either be :class:`TextChannel`, :class:`GroupChannel`, or
:class:`DMChannel`.
If the ``channel`` is a :class:`TextChannel` then the ``user`` parameter
is a :class:`Member`, otherwise it is a :class:`User`.
This requires :attr:`Intents.typing` to be enabled.
:param channel: The location where the typing originated from.
:type channel: :class:`abc.Messageable`
:param user: The user that started typing.
:type user: Union[:class:`User`, :class:`Member`]
:param when: When the typing started as an aware datetime in UTC.
:type when: :class:`datetime.datetime`
.. function:: on_raw_typing(payload)
Called when someone begins typing a message. Unlike :func:`on_typing`, this is
called regardless if the user can be found in the bot's cache or not.
If the typing event is occurring in a guild,
the member that started typing can be accessed via :attr:`RawTypingEvent.member`
This requires :attr:`Intents.typing` to be enabled.
:param payload: The raw typing payload.
:type payload: :class:`RawTypingEvent`
.. function:: on_message(message)
Called when a :class:`Message` is created and sent.
This requires :attr:`Intents.messages` to be enabled.
.. warning::
Your bot's own messages and private messages are sent through this
event. This can lead cases of 'recursion' depending on how your bot was
programmed. If you want the bot to not reply to itself, consider
checking the user IDs. Note that :class:`~ext.commands.Bot` does not
have this problem.
:param message: The current message.
:type message: :class:`Message`
.. function:: on_message_delete(message)
Called when a message is deleted. If the message is not found in the
internal message cache, then this event will not be called.
Messages might not be in cache if the message is too old
or the client is participating in high traffic guilds.
If this occurs increase the :class:`max_messages <Client>` parameter
or use the :func:`on_raw_message_delete` event instead.
This requires :attr:`Intents.messages` to be enabled.
:param message: The deleted message.
:type message: :class:`Message`
.. function:: on_bulk_message_delete(messages)
Called when messages are bulk deleted. If none of the messages deleted
are found in the internal message cache, then this event will not be called.
If individual messages were not found in the internal message cache,
this event will still be called, but the messages not found will not be included in
the messages list. Messages might not be in cache if the message is too old
or the client is participating in high traffic guilds.
If this occurs increase the :class:`max_messages <Client>` parameter
or use the :func:`on_raw_bulk_message_delete` event instead.
This requires :attr:`Intents.messages` to be enabled.
:param messages: The messages that have been deleted.
:type messages: List[:class:`Message`]
.. function:: on_raw_message_delete(payload)
Called when a message is deleted. Unlike :func:`on_message_delete`, this is
called regardless of the message being in the internal message cache or not.
If the message is found in the message cache,
it can be accessed via :attr:`RawMessageDeleteEvent.cached_message`
This requires :attr:`Intents.messages` to be enabled.
:param payload: The raw event payload data.
:type payload: :class:`RawMessageDeleteEvent`
.. function:: on_raw_bulk_message_delete(payload)
Called when a bulk delete is triggered. Unlike :func:`on_bulk_message_delete`, this is
called regardless of the messages being in the internal message cache or not.
If the messages are found in the message cache,
they can be accessed via :attr:`RawBulkMessageDeleteEvent.cached_messages`
This requires :attr:`Intents.messages` to be enabled.
:param payload: The raw event payload data.
:type payload: :class:`RawBulkMessageDeleteEvent`
.. function:: on_message_edit(before, after)
Called when a :class:`Message` receives an update event. If the message is not found
in the internal message cache, then these events will not be called.
Messages might not be in cache if the message is too old
or the client is participating in high traffic guilds.
If this occurs increase the :class:`max_messages <Client>` parameter
or use the :func:`on_raw_message_edit` event instead.
The following non-exhaustive cases trigger this event:
- A message has been pinned or unpinned.
- The message content has been changed.
- The message has received an embed.
- For performance reasons, the embed server does not do this in a "consistent" manner.
- The message's embeds were suppressed or unsuppressed.
- A call message has received an update to its participants or ending time.
This requires :attr:`Intents.messages` to be enabled.
:param before: The previous version of the message.
:type before: :class:`Message`
:param after: The current version of the message.
:type after: :class:`Message`
.. function:: on_raw_message_edit(payload)
Called when a message is edited. Unlike :func:`on_message_edit`, this is called
regardless of the state of the internal message cache.
If the message is found in the message cache,
it can be accessed via :attr:`RawMessageUpdateEvent.cached_message`. The cached message represents
the message before it has been edited. For example, if the content of a message is modified and
triggers the :func:`on_raw_message_edit` coroutine, the :attr:`RawMessageUpdateEvent.cached_message`
will return a :class:`Message` object that represents the message before the content was modified.
Due to the inherently raw nature of this event, the data parameter coincides with
the raw data given by the `gateway <https://discord.com/developers/docs/topics/gateway#message-update>`_.
Since the data payload can be partial, care must be taken when accessing stuff in the dictionary.
One example of a common case of partial data is when the ``'content'`` key is inaccessible. This
denotes an "embed" only edit, which is an edit in which only the embeds are updated by the Discord
embed server.
This requires :attr:`Intents.messages` to be enabled.
:param payload: The raw event payload data.
:type payload: :class:`RawMessageUpdateEvent`
.. function:: on_reaction_add(reaction, user)
Called when a message has a reaction added to it. Similar to :func:`on_message_edit`,
if the message is not found in the internal message cache, then this
event will not be called. Consider using :func:`on_raw_reaction_add` instead.
.. note::
To get the :class:`Message` being reacted, access it via :attr:`Reaction.message`.
This requires :attr:`Intents.reactions` to be enabled.
.. note::
This doesn't require :attr:`Intents.members` within a guild context,
but due to Discord not providing updated user information in a direct message
it's required for direct messages to receive this event.
Consider using :func:`on_raw_reaction_add` if you need this and do not otherwise want
to enable the members intent.
:param reaction: The current state of the reaction.
:type reaction: :class:`Reaction`
:param user: The user who added the reaction.
:type user: Union[:class:`Member`, :class:`User`]
.. function:: on_raw_reaction_add(payload)
Called when a message has a reaction added. Unlike :func:`on_reaction_add`, this is
called regardless of the state of the internal message cache.
This requires :attr:`Intents.reactions` to be enabled.
:param payload: The raw event payload data.
:type payload: :class:`RawReactionActionEvent`
.. function:: on_reaction_remove(reaction, user)
Called when a message has a reaction removed from it. Similar to on_message_edit,
if the message is not found in the internal message cache, then this event
will not be called.
.. note::
To get the message being reacted, access it via :attr:`Reaction.message`.
This requires both :attr:`Intents.reactions` and :attr:`Intents.members` to be enabled.
.. note::
Consider using :func:`on_raw_reaction_remove` if you need this and do not want
to enable the members intent.
:param reaction: The current state of the reaction.
:type reaction: :class:`Reaction`
:param user: The user who added the reaction.
:type user: Union[:class:`Member`, :class:`User`]
.. function:: on_raw_reaction_remove(payload)
Called when a message has a reaction removed. Unlike :func:`on_reaction_remove`, this is
called regardless of the state of the internal message cache.
This requires :attr:`Intents.reactions` to be enabled.
:param payload: The raw event payload data.
:type payload: :class:`RawReactionActionEvent`
.. function:: on_reaction_clear(message, reactions)
Called when a message has all its reactions removed from it. Similar to :func:`on_message_edit`,
if the message is not found in the internal message cache, then this event
will not be called. Consider using :func:`on_raw_reaction_clear` instead.
This requires :attr:`Intents.reactions` to be enabled.
:param message: The message that had its reactions cleared.
:type message: :class:`Message`
:param reactions: The reactions that were removed.
:type reactions: List[:class:`Reaction`]
.. function:: on_raw_reaction_clear(payload)
Called when a message has all its reactions removed. Unlike :func:`on_reaction_clear`,
this is called regardless of the state of the internal message cache.
This requires :attr:`Intents.reactions` to be enabled.
:param payload: The raw event payload data.
:type payload: :class:`RawReactionClearEvent`
.. function:: on_reaction_clear_emoji(reaction)
Called when a message has a specific reaction removed from it. Similar to :func:`on_message_edit`,
if the message is not found in the internal message cache, then this event
will not be called. Consider using :func:`on_raw_reaction_clear_emoji` instead.
This requires :attr:`Intents.reactions` to be enabled.
.. versionadded:: 1.3
:param reaction: The reaction that got cleared.
:type reaction: :class:`Reaction`
.. function:: on_raw_reaction_clear_emoji(payload)
Called when a message has a specific reaction removed from it. Unlike :func:`on_reaction_clear_emoji` this is called
regardless of the state of the internal message cache.
This requires :attr:`Intents.reactions` to be enabled.
.. versionadded:: 1.3
:param payload: The raw event payload data.
:type payload: :class:`RawReactionClearEmojiEvent`
.. function:: on_interaction(interaction)
Called when an interaction happened.
This currently happens due to slash command invocations or components being used.
.. warning::
This is a low level function that is not generally meant to be used.
If you are working with components, consider using the callbacks associated
with the :class:`~discord.ui.View` instead as it provides a nicer user experience.
.. versionadded:: 2.0
:param interaction: The interaction data.
:type interaction: :class:`Interaction`
.. function:: on_application_command(context)
Called when an application command is received.
.. versionadded:: 2.0
:param context: The ApplicationContext associated to the command being received.
:type context: :class:`ApplicationContext`
.. function:: on_application_command_completion(context)
Called when an application command is completed, after any checks have finished.
.. versionadded:: 2.0
:param context: The ApplicationContext associated to the command that was completed.
:type context: :class:`ApplicationContext`
.. function:: on_application_command_error(context, exception)
Called when an application command has an error.
.. versionadded:: 2.0
:param context: The ApplicationContext associated to the command that has an error.
:type context: :class:`ApplicationContext`
:param exception: The DiscordException associated to the error.
:type exception: :class:`DiscordException`
.. function:: on_unknown_application_command(interaction)
Called when an application command was not found in the bot's internal cache.
.. versionadded:: 2.0
:param interaction: The interaction associated to the unknown command.
:type interaction: :class:`Interaction`
.. function:: on_private_channel_update(before, after)
Called whenever a private group DM is updated. e.g. changed name or topic.
This requires :attr:`Intents.messages` to be enabled.
:param before: The updated group channel's old info.
:type before: :class:`GroupChannel`
:param after: The updated group channel's new info.
:type after: :class:`GroupChannel`
.. function:: on_private_channel_pins_update(channel, last_pin)
Called whenever a message is pinned or unpinned from a private channel.
:param channel: The private channel that had its pins updated.
:type channel: :class:`abc.PrivateChannel`
:param last_pin: The latest message that was pinned as an aware datetime in UTC. Could be ``None``.
:type last_pin: Optional[:class:`datetime.datetime`]
.. function:: on_guild_channel_delete(channel)
on_guild_channel_create(channel)
Called whenever a guild channel is deleted or created.
Note that you can get the guild from :attr:`~abc.GuildChannel.guild`.
This requires :attr:`Intents.guilds` to be enabled.
:param channel: The guild channel that got created or deleted.
:type channel: :class:`abc.GuildChannel`
.. function:: on_guild_channel_update(before, after)
Called whenever a guild channel is updated. e.g. changed name, topic, permissions.
This requires :attr:`Intents.guilds` to be enabled.
:param before: The updated guild channel's old info.
:type before: :class:`abc.GuildChannel`
:param after: The updated guild channel's new info.
:type after: :class:`abc.GuildChannel`
.. function:: on_guild_channel_pins_update(channel, last_pin)
Called whenever a message is pinned or unpinned from a guild channel.
This requires :attr:`Intents.guilds` to be enabled.
:param channel: The guild channel that had its pins updated.
:type channel: Union[:class:`abc.GuildChannel`, :class:`Thread`]
:param last_pin: The latest message that was pinned as an aware datetime in UTC. Could be ``None``.
:type last_pin: Optional[:class:`datetime.datetime`]
.. function:: on_thread_join(thread)
Called whenever a thread is joined.
Note that you can get the guild from :attr:`Thread.guild`.
This requires :attr:`Intents.guilds` to be enabled.
.. versionadded:: 2.0
:param thread: The thread that got joined.
:type thread: :class:`Thread`
.. function:: on_thread_create(thread)
Called whenever a thread is created.
Note that you can get the guild from :attr:`Thread.guild`.
This requires :attr:`Intents.guilds` to be enabled.
.. versionadded:: 2.0
:param thread: The thread that got created.
:type thread: :class:`Thread`
.. function:: on_thread_remove(thread)
Called whenever a thread is removed. This is different from a thread being deleted.
Note that you can get the guild from :attr:`Thread.guild`.
This requires :attr:`Intents.guilds` to be enabled.
.. warning::
Due to technical limitations, this event might not be called
as soon as one expects. Since the library tracks thread membership
locally, the API only sends updated thread membership status upon being
synced by joining a thread.
.. versionadded:: 2.0
:param thread: The thread that got removed.
:type thread: :class:`Thread`
.. function:: on_thread_delete(thread)
Called whenever a thread is deleted. If the deleted thread isn't found in internal cache
then this will not be called. Archived threads are not in the cache. Consider using :func:`on_raw_thread_delete`
Note that you can get the guild from :attr:`Thread.guild`.
This requires :attr:`Intents.guilds` to be enabled.
.. versionadded:: 2.0
:param thread: The thread that got deleted.
:type thread: :class:`Thread`
.. function:: on_raw_thread_delete(payload)
Called whenever a thread is deleted. Unlike :func:`on_thread_delete` this is called
regardless of the state of the internal cache.
:param payload: The raw event payload data.
:type payload: :class:`RawThreadDeleteEvent`
.. function:: on_thread_member_join(member)
on_thread_member_remove(member)
Called when a :class:`ThreadMember` leaves or joins a :class:`Thread`.
You can get the thread a member belongs in by accessing :attr:`ThreadMember.thread`.
This requires :attr:`Intents.members` to be enabled.
.. versionadded:: 2.0
:param member: The member who joined or left.
:type member: :class:`ThreadMember`
.. function:: on_thread_update(before, after)
Called whenever a thread is updated.
This requires :attr:`Intents.guilds` to be enabled.
.. versionadded:: 2.0
:param before: The updated thread's old info.
:type before: :class:`Thread`
:param after: The updated thread's new info.
:type after: :class:`Thread`
.. function:: on_guild_integrations_update(guild)
Called whenever an integration is created, modified, or removed from a guild.
This requires :attr:`Intents.integrations` to be enabled.
.. versionadded:: 1.4
:param guild: The guild that had its integrations updated.
:type guild: :class:`Guild`
.. function:: on_integration_create(integration)
Called when an integration is created.
This requires :attr:`Intents.integrations` to be enabled.
.. versionadded:: 2.0
:param integration: The integration that was created.
:type integration: :class:`Integration`
.. function:: on_integration_update(integration)
Called when an integration is updated.
This requires :attr:`Intents.integrations` to be enabled.
.. versionadded:: 2.0
:param integration: The integration that was created.
:type integration: :class:`Integration`
.. function:: on_raw_integration_delete(payload)
Called when an integration is deleted.
This requires :attr:`Intents.integrations` to be enabled.
.. versionadded:: 2.0
:param payload: The raw event payload data.
:type payload: :class:`RawIntegrationDeleteEvent`
.. function:: on_webhooks_update(channel)
Called whenever a webhook is created, modified, or removed from a guild channel.
This requires :attr:`Intents.webhooks` to be enabled.
:param channel: The channel that had its webhooks updated.
:type channel: :class:`abc.GuildChannel`
.. function:: on_member_join(member)
on_member_remove(member)
Called when a :class:`Member` leaves or joins a :class:`Guild`.
This requires :attr:`Intents.members` to be enabled.
:param member: The member who joined or left.
:type member: :class:`Member`
.. function:: on_member_update(before, after)
Called when a :class:`Member` updates their profile.
This is called when one or more of the following things change:
- nickname
- roles
- pending
- communication_disabled_until
- timed_out
This requires :attr:`Intents.members` to be enabled.
:param before: The updated member's old info.
:type before: :class:`Member`
:param after: The updated member's updated info.
:type after: :class:`Member`
.. function:: on_presence_update(before, after)
Called when a :class:`Member` updates their presence.
This is called when one or more of the following things change:
- status
- activity
This requires :attr:`Intents.presences` and :attr:`Intents.members` to be enabled.
.. versionadded:: 2.0
:param before: The updated member's old info.
:type before: :class:`Member`
:param after: The updated member's updated info.
:type after: :class:`Member`
.. function:: on_user_update(before, after)
Called when a :class:`User` updates their profile.
This is called when one or more of the following things change:
- avatar
- username
- discriminator
This requires :attr:`Intents.members` to be enabled.
:param before: The updated user's old info.
:type before: :class:`User`
:param after: The updated user's updated info.
:type after: :class:`User`
.. function:: on_guild_join(guild)
Called when a :class:`Guild` is either created by the :class:`Client` or when the
:class:`Client` joins a guild.
This requires :attr:`Intents.guilds` to be enabled.
:param guild: The guild that was joined.
:type guild: :class:`Guild`
.. function:: on_guild_remove(guild)
Called when a :class:`Guild` is removed from the :class:`Client`.
This happens through, but not limited to, these circumstances:
- The client got banned.
- The client got kicked.
- The client left the guild.
- The client or the guild owner deleted the guild.
In order for this event to be invoked then the :class:`Client` must have
been part of the guild to begin with. (i.e. it is part of :attr:`Client.guilds`)
This requires :attr:`Intents.guilds` to be enabled.
:param guild: The guild that got removed.
:type guild: :class:`Guild`
.. function:: on_guild_update(before, after)
Called when a :class:`Guild` updates, for example:
- Changed name
- Changed AFK channel
- Changed AFK timeout
- etc
This requires :attr:`Intents.guilds` to be enabled.
:param before: The guild prior to being updated.
:type before: :class:`Guild`
:param after: The guild after being updated.
:type after: :class:`Guild`
.. function:: on_guild_role_create(role)
on_guild_role_delete(role)
Called when a :class:`Guild` creates or deletes a new :class:`Role`.
To get the guild it belongs to, use :attr:`Role.guild`.
This requires :attr:`Intents.guilds` to be enabled.
:param role: The role that was created or deleted.
:type role: :class:`Role`
.. function:: on_guild_role_update(before, after)
Called when a :class:`Role` is changed guild-wide.
This requires :attr:`Intents.guilds` to be enabled.
:param before: The updated role's old info.
:type before: :class:`Role`
:param after: The updated role's updated info.
:type after: :class:`Role`
.. function:: on_guild_emojis_update(guild, before, after)
Called when a :class:`Guild` adds or removes :class:`Emoji`.
This requires :attr:`Intents.emojis_and_stickers` to be enabled.
:param guild: The guild who got their emojis updated.
:type guild: :class:`Guild`
:param before: A list of emojis before the update.
:type before: Sequence[:class:`Emoji`]
:param after: A list of emojis after the update.
:type after: Sequence[:class:`Emoji`]
.. function:: on_guild_stickers_update(guild, before, after)
Called when a :class:`Guild` updates its stickers.
This requires :attr:`Intents.emojis_and_stickers` to be enabled.
.. versionadded:: 2.0
:param guild: The guild who got their stickers updated.
:type guild: :class:`Guild`
:param before: A list of stickers before the update.
:type before: Sequence[:class:`GuildSticker`]
:param after: A list of stickers after the update.
:type after: Sequence[:class:`GuildSticker`]
.. function:: on_guild_available(guild)
on_guild_unavailable(guild)
Called when a guild becomes available or unavailable. The guild must have
existed in the :attr:`Client.guilds` cache.
This requires :attr:`Intents.guilds` to be enabled.
:param guild: The :class:`Guild` that has changed availability.
.. function:: on_voice_state_update(member, before, after)
Called when a :class:`Member` changes their :class:`VoiceState`.
The following, but not limited to, examples illustrate when this event is called:
- A member joins a voice or stage channel.
- A member leaves a voice or stage channel.
- A member is muted or deafened by their own accord.
- A member is muted or deafened by a guild administrator.
This requires :attr:`Intents.voice_states` to be enabled.
:param member: The member whose voice states changed.
:type member: :class:`Member`
:param before: The voice state prior to the changes.
:type before: :class:`VoiceState`
:param after: The voice state after the changes.
:type after: :class:`VoiceState`
.. function:: on_stage_instance_create(stage_instance)
on_stage_instance_delete(stage_instance)
Called when a :class:`StageInstance` is created or deleted for a :class:`StageChannel`.
.. versionadded:: 2.0
:param stage_instance: The stage instance that was created or deleted.
:type stage_instance: :class:`StageInstance`
.. function:: on_stage_instance_update(before, after)
Called when a :class:`StageInstance` is updated.
The following, but not limited to, examples illustrate when this event is called:
- The topic is changed.
- The privacy level is changed.
.. versionadded:: 2.0
:param before: The stage instance before the update.
:type before: :class:`StageInstance`
:param after: The stage instance after the update.
:type after: :class:`StageInstance`
.. function:: on_member_ban(guild, user)
Called when user gets banned from a :class:`Guild`.
This requires :attr:`Intents.bans` to be enabled.
:param guild: The guild the user got banned from.
:type guild: :class:`Guild`
:param user: The user that got banned.
Can be either :class:`User` or :class:`Member` depending if
the user was in the guild or not at the time of removal.
:type user: Union[:class:`User`, :class:`Member`]
.. function:: on_member_unban(guild, user)
Called when a :class:`User` gets unbanned from a :class:`Guild`.
This requires :attr:`Intents.bans` to be enabled.
:param guild: The guild the user got unbanned from.
:type guild: :class:`Guild`
:param user: The user that got unbanned.
:type user: :class:`User`
.. function:: on_invite_create(invite)
Called when an :class:`Invite` is created.
You must have the :attr:`~Permissions.manage_channels` permission to receive this.
.. versionadded:: 1.3
.. note::
There is a rare possibility that the :attr:`Invite.guild` and :attr:`Invite.channel`
attributes will be of :class:`Object` rather than the respective models.
This requires :attr:`Intents.invites` to be enabled.
:param invite: The invite that was created.
:type invite: :class:`Invite`
.. function:: on_invite_delete(invite)
Called when an :class:`Invite` is deleted.
You must have the :attr:`~Permissions.manage_channels` permission to receive this.
.. versionadded:: 1.3
.. note::
There is a rare possibility that the :attr:`Invite.guild` and :attr:`Invite.channel`
attributes will be of :class:`Object` rather than the respective models.
Outside of those two attributes, the only other attribute guaranteed to be
filled by the Discord gateway for this event is :attr:`Invite.code`.
This requires :attr:`Intents.invites` to be enabled.
:param invite: The invite that was deleted.
:type invite: :class:`Invite`
.. function:: on_group_join(channel, user)
on_group_remove(channel, user)
Called when someone joins or leaves a :class:`GroupChannel`.
:param channel: The group that the user joined or left.
:type channel: :class:`GroupChannel`
:param user: The user that joined or left.
:type user: :class:`User`
.. function:: on_scheduled_event_create(event)
Called when an :class:`ScheduledEvent` is created.
This requires :attr:`Intents.scheduled_events` to be enabled.
:param event: The newly created scheduled event.
:type event: :class:`ScheduledEvent`
.. function:: on_scheduled_event_update(before, after)
Called when a scheduled event is updated.
This requires :attr:`Intents.scheduled_events` to be enabled.
:param before: The old scheduled event.
:type before: :class:`ScheduledEvent`
:param after: The updated scheduled event.
:type after: :class:`ScheduledEvent`
.. function:: on_scheduled_event_delete(event)
Called when a scheduled event is deleted.
This requires :attr:`Intents.scheduled_events` to be enabled.
:param event: The deleted scheduled event.
:type event: :class:`ScheduledEvent`
.. function:: on_scheduled_event_user_add(event, member)
Called when a user subscribes to an event. If the member or event
is not found in the internal cache, then this event will not be
called. Consider using :func:`on_raw_scheduled_event_user_add` instead.
This requires :attr:`Intents.scheduled_events` to be enabled.
:param event: The scheduled event subscribed to.
:type event: :class:`ScheduledEvent`
:param member: The member who subscribed.
:type member: :class:`Member`
.. function:: on_raw_scheduled_event_user_add(payload)
Called when a user subscribes to an event. Unlike
:meth:`on_scheduled_event_user_add`, this will be called
regardless of the state of the internal cache.
This requires :attr:`Intents.scheduled_events` to be enabled.
:param payload: The raw event payload data.
:type payload: :class:`RawScheduledEventSubscription`
.. function:: on_scheduled_event_user_remove(event, member)
Called when a user unsubscribes to an event. If the member or event is
not found in the internal cache, then this event will not be called.
Consider using :func:`on_raw_scheduled_event_user_remove` instead.
This requires :attr:`Intents.scheduled_events` to be enabled.
:param event: The scheduled event unsubscribed from.
:type event: :class:`ScheduledEvent`
:param member: The member who unsubscribed.
:type member: :class:`Member`
.. function:: on_raw_scheduled_event_user_remove(payload)
Called when a user unsubscribes to an event. Unlike
:meth:`on_scheduled_event_user_remove`, this will be called
regardless of the state of the internal cache.
This requires :attr:`Intents.scheduled_events` to be enabled.
:param payload: The raw event payload data.
:type payload: :class:`RawScheduledEventSubscription`
.. function:: on_auto_moderation_rule_create(rule)
Called when an auto moderation rule is created.
The bot must have :attr:`~Permissions.manage_guild` to receive this, and
:attr:`Intents.auto_moderation_configuration` must be enabled.
:param rule: The newly created rule.
:type rule: :class:`AutoModRule`
.. function:: on_auto_moderation_rule_update(rule)
Called when an auto moderation rule is updated.
The bot must have :attr:`~Permissions.manage_guild` to receive this, and
:attr:`Intents.auto_moderation_configuration` must be enabled.
:param rule: The updated rule.
:type rule: :class:`AutoModRule`
.. function:: on_auto_moderation_rule_delete(rule)
Called when an auto moderation rule is deleted.
The bot must have :attr:`~Permissions.manage_guild` to receive this, and
:attr:`Intents.auto_moderation_configuration` must be enabled.
:param rule: The deleted rule.
:type rule: :class:`AutoModRule`
.. function:: on_auto_moderation_action_execution(guild, action)
Called when an auto moderation action is executed.
The bot must have :attr:`~Permissions.manage_guild` to receive this, and
:attr:`Intents.auto_moderation_execution` must be enabled.
:param payload: The event's data.
:type payload: :class:`AutoModActionExecutionEvent`
.. autofunction:: discord.utils.find
.. autofunction:: discord.utils.get
.. autofunction:: discord.utils.snowflake_time
.. autofunction:: discord.utils.oauth_url
.. autofunction:: discord.utils.remove_markdown
.. autofunction:: discord.utils.escape_markdown
.. autofunction:: discord.utils.escape_mentions
.. autofunction:: discord.utils.resolve_invite
.. autofunction:: discord.utils.resolve_template
.. autofunction:: discord.utils.sleep_until
.. autofunction:: discord.utils.utcnow
.. autofunction:: discord.utils.format_dt
.. autofunction:: discord.utils.as_chunks
.. autofunction:: discord.utils.time_snowflake
.. autofunction:: discord.utils.generate_snowflake
.. autofunction:: discord.utils.basic_autocomplete
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 :class:`enum.Enum`.
Specifies the input type of an option.
.. versionadded:: 2.0
.. attribute:: sub_command
A slash subcommand.
.. attribute:: sub_command_group
A slash command group.
.. attribute:: string
A string.
.. attribute:: integer
An integer.
.. attribute:: boolean
A boolean.
.. attribute:: user
A user from the current channel. This will be converted to an instance of :class:`.User` in private channels, else :class:`.Member`
.. attribute:: channel
A channel from the current guild.
.. attribute:: role
A role from the current guild.
.. attribute:: mentionable
A mentionable (user or role).
.. attribute:: number
A floating number.
.. attribute:: attachment
An attachment. Currently in beta.
Specifies the type of channel.
.. attribute:: text
A text channel.
.. attribute:: voice
A voice channel.
.. attribute:: private
A private text channel. Also called a direct message.
.. attribute:: group
A private group text channel.
.. attribute:: category
A category channel.
.. attribute:: news
A guild news channel.
.. attribute:: stage_voice
A guild stage voice channel.
.. versionadded:: 1.7
.. attribute:: news_thread
A news thread
.. versionadded:: 2.0
.. attribute:: public_thread
A public thread
.. versionadded:: 2.0
.. attribute:: private_thread
A private thread
.. versionadded:: 2.0
.. attribute:: directory
A guild directory entry.
Used in hub guilds.
In Experiment.
.. versionadded:: 2.0
.. attribute:: forum
User can only write in threads.
Similar functionality to a forum.
In Experiment.
.. versionadded:: 2.0
Specifies the type of :class:`Message`. This is used to denote if a message is to be interpreted as a system message or a regular message.
.. describe:: x == y
Checks if two messages are equal.
.. describe:: x != y
Checks if two messages are not equal.
.. attribute:: default
The default message type. This is the same as regular messages.
.. attribute:: recipient_add
The system message when a user is added to a group private
message or a thread.
.. attribute:: recipient_remove
The system message when a user is removed from a group private
message or a thread.
.. attribute:: call
The system message denoting call state, e.g. missed call, started call,
etc.
.. attribute:: channel_name_change
The system message denoting that a channel's name has been changed.
.. attribute:: channel_icon_change
The system message denoting that a channel's icon has been changed.
.. attribute:: pins_add
The system message denoting that a pinned message has been added to a channel.
.. attribute:: new_member
The system message denoting that a new member has joined a Guild.
.. attribute:: premium_guild_subscription
The system message denoting that a member has "nitro boosted" a guild.
.. attribute:: premium_guild_tier_1
The system message denoting that a member has "nitro boosted" a guild
and it achieved level 1.
.. attribute:: premium_guild_tier_2
The system message denoting that a member has "nitro boosted" a guild
and it achieved level 2.
.. attribute:: premium_guild_tier_3
The system message denoting that a member has "nitro boosted" a guild
and it achieved level 3.
.. attribute:: channel_follow_add
The system message denoting that an announcement channel has been followed.
.. versionadded:: 1.3
.. attribute:: guild_stream
The system message denoting that a member is streaming in the guild.
.. versionadded:: 1.7
.. attribute:: guild_discovery_disqualified
The system message denoting that the guild is no longer eligible for Server
Discovery.
.. versionadded:: 1.7
.. attribute:: guild_discovery_requalified
The system message denoting that the guild has become eligible again for Server
Discovery.
.. versionadded:: 1.7
.. attribute:: guild_discovery_grace_period_initial_warning
The system message denoting that the guild has failed to meet the Server
Discovery requirements for one week.
.. versionadded:: 1.7
.. attribute:: 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.
.. versionadded:: 1.7
.. attribute:: 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.
.. versionadded:: 2.0
.. attribute:: reply
The system message denoting that the author is replying to a message.
.. versionadded:: 2.0
.. attribute:: application_command
The system message denoting that an application (or "slash") command was executed.
.. versionadded:: 2.0
.. attribute:: guild_invite_reminder
The system message sent as a reminder to invite people to the guild.
.. versionadded:: 2.0
.. attribute:: thread_starter_message
The system message denoting the message in the thread that is the one that started the
thread's conversation topic.
.. versionadded:: 2.0
.. attribute:: context_menu_command
The system message denoting that an context menu command was executed.
.. versionadded:: 2.0
Represents Discord User flags.
.. attribute:: staff
The user is a Discord Employee.
.. attribute:: partner
The user is a Discord Partner.
.. attribute:: hypesquad
The user is a HypeSquad Events member.
.. attribute:: bug_hunter
The user is a Bug Hunter.
.. attribute:: mfa_sms
The user has SMS recovery for Multi Factor Authentication enabled.
.. attribute:: premium_promo_dismissed
The user has dismissed the Discord Nitro promotion.
.. attribute:: hypesquad_bravery
The user is a HypeSquad Bravery member.
.. attribute:: hypesquad_brilliance
The user is a HypeSquad Brilliance member.
.. attribute:: hypesquad_balance
The user is a HypeSquad Balance member.
.. attribute:: early_supporter
The user is an Early Supporter.
.. attribute:: team_user
The user is a Team User.
.. attribute:: partner_or_verification_application
Relates to partner/verification applications.
.. attribute:: system
The user is a system user (i.e. represents Discord officially).
.. attribute:: has_unread_urgent_messages
The user has an unread system message.
.. attribute:: bug_hunter_level_2
The user is a Bug Hunter Level 2.
.. attribute:: verified_bot
The user is a Verified Bot.
.. attribute:: verified_bot_developer
The user is an Early Verified Bot Developer.
.. attribute:: discord_certified_moderator
The user is a Discord Certified Moderator.
.. attribute:: bot_http_interactions
The bot has set an interactions endpoint url.
.. attribute:: spammer
The user is disabled for being a spammer.
Specifies the type of :class:`Activity`. This is used to check how to interpret the activity itself.
.. attribute:: unknown
An unknown activity type. This should generally not happen.
.. attribute:: playing
A "Playing" activity type.
.. attribute:: streaming
A "Streaming" activity type.
.. attribute:: listening
A "Listening" activity type.
.. attribute:: watching
A "Watching" activity type.
.. attribute:: custom
A custom activity type.
.. attribute:: competing
A competing activity type.
.. versionadded:: 1.5
Specifies the type of :class:`Interaction`.
.. versionadded:: 2.0
.. attribute:: ping
Represents Discord pinging to see if the interaction response server is alive.
.. attribute:: application_command
Represents a slash command interaction.
.. attribute:: component
Represents a component based interaction, i.e. using the Discord Bot UI Kit.
.. attribute:: auto_complete
Represents a autocomplete interaction for slash commands.
Specifies the response type for the interaction.
.. versionadded:: 2.0
.. attribute:: pong
Pongs the interaction when given a ping.
See also :meth:`InteractionResponse.pong`
.. attribute:: channel_message
Respond to the interaction with a message.
See also :meth:`InteractionResponse.send_message`
.. attribute:: deferred_channel_message
Responds to the interaction with a message at a later time.
See also :meth:`InteractionResponse.defer`
.. attribute:: 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 :meth:`InteractionResponse.defer`
.. attribute:: message_update
Responds to the interaction by editing the message.
See also :meth:`InteractionResponse.edit_message`
.. attribute:: auto_complete_result
Responds to autocomplete requests.
Represents the component type of a component.
.. versionadded:: 2.0
.. attribute:: action_row
Represents the group component which holds different components in a row.
.. attribute:: button
Represents a button component.
.. attribute:: select
Represents a select component.
.. attribute:: input_text
Represents an input_text component.
Represents the style of the button component.
.. versionadded:: 2.0
.. attribute:: primary
Represents a blurple button for the primary action.
.. attribute:: secondary
Represents a grey button for the secondary action.
.. attribute:: success
Represents a green button for a successful action.
.. attribute:: danger
Represents a red button for a dangerous action.
.. attribute:: link
Represents a link button.
.. attribute:: blurple
An alias for :attr:`primary`.
.. attribute:: grey
An alias for :attr:`secondary`.
.. attribute:: gray
An alias for :attr:`secondary`.
.. attribute:: green
An alias for :attr:`success`.
.. attribute:: red
An alias for :attr:`danger`.
.. attribute:: url
An alias for :attr:`link`.
Represents the style of the input text component.
.. versionadded:: 2.0
.. attribute:: short
Represents a single-line input text field.
.. attribute:: long
Represents a multi-line input text field.
.. attribute:: singleline
An alias for :attr:`short`.
.. attribute:: multiline
An alias for :attr:`long`.
.. attribute:: paragraph
An alias for :attr:`long`.
Specifies the region a voice server belongs to.
.. attribute:: amsterdam
The Amsterdam region.
.. attribute:: brazil
The Brazil region.
.. attribute:: dubai
The Dubai region.
.. versionadded:: 1.3
.. attribute:: eu_central
The EU Central region.
.. attribute:: eu_west
The EU West region.
.. attribute:: europe
The Europe region.
.. versionadded:: 1.3
.. attribute:: frankfurt
The Frankfurt region.
.. attribute:: hongkong
The Hong Kong region.
.. attribute:: india
The India region.
.. versionadded:: 1.2
.. attribute:: japan
The Japan region.
.. attribute:: london
The London region.
.. attribute:: russia
The Russia region.
.. attribute:: singapore
The Singapore region.
.. attribute:: southafrica
The South Africa region.
.. attribute:: south_korea
The South Korea region.
.. attribute:: sydney
The Sydney region.
.. attribute:: us_central
The US Central region.
.. attribute:: us_east
The US East region.
.. attribute:: us_south
The US South region.
.. attribute:: us_west
The US West region.
.. attribute:: vip_amsterdam
The Amsterdam region for VIP guilds.
.. attribute:: vip_us_east
The US East region for VIP guilds.
.. attribute:: vip_us_west
The US West region for VIP guilds.
Specifies a :class:`Guild`'s verification level, which is the criteria in which a member must meet before being able to send messages to the guild.
.. versionadded:: 2.0
.. describe:: x == y
Checks if two verification levels are equal.
.. describe:: x != y
Checks if two verification levels are not equal.
.. describe:: x > y
Checks if a verification level is higher than another.
.. describe:: x < y
Checks if a verification level is lower than another.
.. describe:: x >= y
Checks if a verification level is higher or equal to another.
.. describe:: x <= y
Checks if a verification level is lower or equal to another.
.. attribute:: none
No criteria set.
.. attribute:: low
Member must have a verified email on their Discord account.
.. attribute:: medium
Member must have a verified email and be registered on Discord for more
than five minutes.
.. attribute:: 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.
.. attribute:: highest
Member must have a verified phone on their Discord account.
Specifies whether a :class:`Guild` has notifications on for all messages or mentions only by default.
.. versionadded:: 2.0
.. describe:: x == y
Checks if two notification levels are equal.
.. describe:: x != y
Checks if two notification levels are not equal.
.. describe:: x > y
Checks if a notification level is higher than another.
.. describe:: x < y
Checks if a notification level is lower than another.
.. describe:: x >= y
Checks if a notification level is higher or equal to another.
.. describe:: x <= y
Checks if a notification level is lower or equal to another.
.. attribute:: all_messages
Members receive notifications for every message regardless of them being mentioned.
.. attribute:: only_mentions
Members receive notifications for messages they are mentioned in.
Specifies a :class:`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.
.. versionadded:: 2.0
.. describe:: x == y
Checks if two content filter levels are equal.
.. describe:: x != y
Checks if two content filter levels are not equal.
.. describe:: x > y
Checks if a content filter level is higher than another.
.. describe:: x < y
Checks if a content filter level is lower than another.
.. describe:: x >= y
Checks if a content filter level is higher or equal to another.
.. describe:: x <= y
Checks if a content filter level is lower or equal to another.
.. attribute:: disabled
The guild does not have the content filter enabled.
.. attribute:: no_role
The guild has the content filter enabled for members without a role.
.. attribute:: all_members
The guild has the content filter enabled for every member.
Specifies a :class:`Member` 's status.
.. attribute:: online
The member is online.
.. attribute:: offline
The member is offline.
.. attribute:: idle
The member is idle.
.. attribute:: dnd
The member is "Do Not Disturb".
.. attribute:: do_not_disturb
An alias for :attr:`dnd`.
.. attribute:: invisible
The member is "invisible". In reality, this is only used in sending
a presence a la :meth:`Client.change_presence`. When you receive a
user's presence this will be :attr:`offline` instead.
.. attribute:: streaming
The member is streaming.
Represents the type of action being done for a :class:`AuditLogEntry`, which is retrievable via :meth:`Guild.audit_logs`.
.. attribute:: 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 :attr:`~AuditLogEntry.target` is
the :class:`Guild`.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.afk_channel`
- :attr:`~AuditLogDiff.system_channel`
- :attr:`~AuditLogDiff.afk_timeout`
- :attr:`~AuditLogDiff.default_message_notifications`
- :attr:`~AuditLogDiff.explicit_content_filter`
- :attr:`~AuditLogDiff.mfa_level`
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.owner`
- :attr:`~AuditLogDiff.splash`
- :attr:`~AuditLogDiff.discovery_splash`
- :attr:`~AuditLogDiff.icon`
- :attr:`~AuditLogDiff.banner`
- :attr:`~AuditLogDiff.vanity_url_code`
.. attribute:: channel_create
A new channel was created.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
either a :class:`abc.GuildChannel` or :class:`Object` with an ID.
A more filled out object in the :class:`Object` case can be found
by using :attr:`~AuditLogEntry.after`.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.type`
- :attr:`~AuditLogDiff.overwrites`
.. attribute:: 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 :attr:`~AuditLogEntry.target` is
the :class:`abc.GuildChannel` or :class:`Object` with an ID.
A more filled out object in the :class:`Object` case can be found
by using :attr:`~AuditLogEntry.after` or :attr:`~AuditLogEntry.before`.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.type`
- :attr:`~AuditLogDiff.position`
- :attr:`~AuditLogDiff.overwrites`
- :attr:`~AuditLogDiff.topic`
- :attr:`~AuditLogDiff.bitrate`
- :attr:`~AuditLogDiff.rtc_region`
- :attr:`~AuditLogDiff.video_quality_mode`
- :attr:`~AuditLogDiff.default_auto_archive_duration`
.. attribute:: channel_delete
A channel was deleted.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
an :class:`Object` with an ID.
A more filled out object can be found by using the
:attr:`~AuditLogEntry.before` object.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.type`
- :attr:`~AuditLogDiff.overwrites`
.. attribute:: overwrite_create
A channel permission overwrite was created.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`abc.GuildChannel` or :class:`Object` with an ID.
When this is the action, the type of :attr:`~AuditLogEntry.extra` is
either a :class:`Role` or :class:`Member`. If the object is not found
then it is a :class:`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 :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.deny`
- :attr:`~AuditLogDiff.allow`
- :attr:`~AuditLogDiff.id`
- :attr:`~AuditLogDiff.type`
.. attribute:: overwrite_update
A channel permission overwrite was changed, this is typically
when the permission values change.
See :attr:`overwrite_create` for more information on how the
:attr:`~AuditLogEntry.target` and :attr:`~AuditLogEntry.extra` fields
are set.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.deny`
- :attr:`~AuditLogDiff.allow`
- :attr:`~AuditLogDiff.id`
- :attr:`~AuditLogDiff.type`
.. attribute:: overwrite_delete
A channel permission overwrite was deleted.
See :attr:`overwrite_create` for more information on how the
:attr:`~AuditLogEntry.target` and :attr:`~AuditLogEntry.extra` fields
are set.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.deny`
- :attr:`~AuditLogDiff.allow`
- :attr:`~AuditLogDiff.id`
- :attr:`~AuditLogDiff.type`
.. attribute:: kick
A member was kicked.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`User` who got kicked.
When this is the action, :attr:`~AuditLogEntry.changes` is empty.
.. attribute:: member_prune
A member prune was triggered.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
set to ``None``.
When this is the action, the type of :attr:`~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, :attr:`~AuditLogEntry.changes` is empty.
.. attribute:: ban
A member was banned.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`User` who got banned.
When this is the action, :attr:`~AuditLogEntry.changes` is empty.
.. attribute:: unban
A member was unbanned.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`User` who got unbanned.
When this is the action, :attr:`~AuditLogEntry.changes` is empty.
.. attribute:: 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 undo'd)
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Member` or :class:`User` who got updated.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.nick`
- :attr:`~AuditLogDiff.mute`
- :attr:`~AuditLogDiff.deaf`
.. attribute:: 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 :attr:`~AuditLogEntry.target` is
the :class:`Member` or :class:`User` who got the role.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.roles`
.. attribute:: 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 :attr:`~AuditLogEntry.extra` is
set to an unspecified proxy object with two attributes:
- ``channel``: A :class:`TextChannel` or :class:`Object` with the channel ID where the members were moved.
- ``count``: An integer specifying how many members were moved.
.. versionadded:: 1.3
.. attribute:: 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 :attr:`~AuditLogEntry.extra` is
set to an unspecified proxy object with one attribute:
- ``count``: An integer specifying how many members were disconnected.
.. versionadded:: 1.3
.. attribute:: bot_add
A bot was added to the guild.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Member` or :class:`User` which was added to the guild.
.. versionadded:: 1.3
.. attribute:: role_create
A new role was created.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Role` or a :class:`Object` with the ID.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.colour`
- :attr:`~AuditLogDiff.mentionable`
- :attr:`~AuditLogDiff.hoist`
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.permissions`
.. attribute:: 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 :attr:`~AuditLogEntry.target` is
the :class:`Role` or a :class:`Object` with the ID.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.colour`
- :attr:`~AuditLogDiff.mentionable`
- :attr:`~AuditLogDiff.hoist`
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.permissions`
.. attribute:: role_delete
A role was deleted.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Role` or a :class:`Object` with the ID.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.colour`
- :attr:`~AuditLogDiff.mentionable`
- :attr:`~AuditLogDiff.hoist`
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.permissions`
.. attribute:: invite_create
An invite was created.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Invite` that was created.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.max_age`
- :attr:`~AuditLogDiff.code`
- :attr:`~AuditLogDiff.temporary`
- :attr:`~AuditLogDiff.inviter`
- :attr:`~AuditLogDiff.channel`
- :attr:`~AuditLogDiff.uses`
- :attr:`~AuditLogDiff.max_uses`
.. attribute:: invite_update
An invite was updated.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Invite` that was updated.
.. attribute:: invite_delete
An invite was deleted.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Invite` that was deleted.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.max_age`
- :attr:`~AuditLogDiff.code`
- :attr:`~AuditLogDiff.temporary`
- :attr:`~AuditLogDiff.inviter`
- :attr:`~AuditLogDiff.channel`
- :attr:`~AuditLogDiff.uses`
- :attr:`~AuditLogDiff.max_uses`
.. attribute:: webhook_create
A webhook was created.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Object` with the webhook ID.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.channel`
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.type` (always set to ``1`` if so)
.. attribute:: 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 :attr:`~AuditLogEntry.target` is
the :class:`Object` with the webhook ID.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.channel`
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.avatar`
.. attribute:: webhook_delete
A webhook was deleted.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Object` with the webhook ID.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.channel`
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.type` (always set to ``1`` if so)
.. attribute:: emoji_create
An emoji was created.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Emoji` or :class:`Object` with the emoji ID.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
.. attribute:: emoji_update
An emoji was updated. This triggers when the name has changed.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Emoji` or :class:`Object` with the emoji ID.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
.. attribute:: emoji_delete
An emoji was deleted.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Object` with the emoji ID.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
.. attribute:: 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 :attr:`~AuditLogEntry.target` is
the :class:`Member` or :class:`User` who had their message deleted.
When this is the action, the type of :attr:`~AuditLogEntry.extra` is
set to an unspecified proxy object with two attributes:
- ``count``: An integer specifying how many messages were deleted.
- ``channel``: A :class:`TextChannel` or :class:`Object` with the channel ID where the message got deleted.
.. attribute:: message_bulk_delete
Messages were bulk deleted by a moderator.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`TextChannel` or :class:`Object` with the ID of the channel that was purged.
When this is the action, the type of :attr:`~AuditLogEntry.extra` is
set to an unspecified proxy object with one attribute:
- ``count``: An integer specifying how many messages were deleted.
.. versionadded:: 1.3
.. attribute:: message_pin
A message was pinned in a channel.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Member` or :class:`User` who had their message pinned.
When this is the action, the type of :attr:`~AuditLogEntry.extra` is
set to an unspecified proxy object with two attributes:
- ``channel``: A :class:`TextChannel` or :class:`Object` with the channel ID where the message was pinned.
- ``message_id``: the ID of the message which was pinned.
.. versionadded:: 1.3
.. attribute:: message_unpin
A message was unpinned in a channel.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Member` or :class:`User` who had their message unpinned.
When this is the action, the type of :attr:`~AuditLogEntry.extra` is
set to an unspecified proxy object with two attributes:
- ``channel``: A :class:`TextChannel` or :class:`Object` with the channel ID where the message was unpinned.
- ``message_id``: the ID of the message which was unpinned.
.. versionadded:: 1.3
.. attribute:: integration_create
A guild integration was created.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Object` with the integration ID of the integration which was created.
.. versionadded:: 1.3
.. attribute:: integration_update
A guild integration was updated.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Object` with the integration ID of the integration which was updated.
.. versionadded:: 1.3
.. attribute:: integration_delete
A guild integration was deleted.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Object` with the integration ID of the integration which was deleted.
.. versionadded:: 1.3
.. attribute:: stage_instance_create
A stage instance was started.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`StageInstance` or :class:`Object` with the ID of the stage
instance which was created.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.topic`
- :attr:`~AuditLogDiff.privacy_level`
.. versionadded:: 2.0
.. attribute:: stage_instance_update
A stage instance was updated.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`StageInstance` or :class:`Object` with the ID of the stage
instance which was updated.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.topic`
- :attr:`~AuditLogDiff.privacy_level`
.. versionadded:: 2.0
.. attribute:: stage_instance_delete
A stage instance was ended.
.. versionadded:: 2.0
.. attribute:: sticker_create
A sticker was created.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`GuildSticker` or :class:`Object` with the ID of the sticker
which was updated.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.emoji`
- :attr:`~AuditLogDiff.type`
- :attr:`~AuditLogDiff.format_type`
- :attr:`~AuditLogDiff.description`
- :attr:`~AuditLogDiff.available`
.. versionadded:: 2.0
.. attribute:: sticker_update
A sticker was updated.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`GuildSticker` or :class:`Object` with the ID of the sticker
which was updated.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.emoji`
- :attr:`~AuditLogDiff.type`
- :attr:`~AuditLogDiff.format_type`
- :attr:`~AuditLogDiff.description`
- :attr:`~AuditLogDiff.available`
.. versionadded:: 2.0
.. attribute:: sticker_delete
A sticker was deleted.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`GuildSticker` or :class:`Object` with the ID of the sticker
which was updated.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.emoji`
- :attr:`~AuditLogDiff.type`
- :attr:`~AuditLogDiff.format_type`
- :attr:`~AuditLogDiff.description`
- :attr:`~AuditLogDiff.available`
.. versionadded:: 2.0
.. attribute:: scheduled_event_create
A scheduled event was created.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`ScheduledEvent` or :class:`Object` with the ID of the thread which
was deleted.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.description`
- :attr:`~AuditLogDiff.channel`
- :attr:`~AuditLogDiff.privacy_level`
- :attr:`~AuditLogDiff.location`
- :attr:`~AuditLogDiff.status`
- :attr:`~AuditLogDiff.location_type`
.. versionadded:: 2.0
.. attribute:: scheduled_event_update
A scheduled event was updated.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`ScheduledEvent` or :class:`Object` with the ID of the thread which
was deleted.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.description`
- :attr:`~AuditLogDiff.channel`
- :attr:`~AuditLogDiff.privacy_level`
- :attr:`~AuditLogDiff.location`
- :attr:`~AuditLogDiff.status`
- :attr:`~AuditLogDiff.location_type`
.. versionadded:: 2.0
.. attribute:: scheduled_event_delete
A scheduled event was deleted.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`ScheduledEvent` or :class:`Object` with the ID of the thread which
was deleted.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.description`
- :attr:`~AuditLogDiff.channel`
- :attr:`~AuditLogDiff.privacy_level`
- :attr:`~AuditLogDiff.location`
- :attr:`~AuditLogDiff.status`
- :attr:`~AuditLogDiff.location_type`
.. versionadded:: 2.0
.. attribute:: thread_create
A thread was created.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Thread` or :class:`Object` with the ID of the thread which
was created.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.archived`
- :attr:`~AuditLogDiff.locked`
- :attr:`~AuditLogDiff.auto_archive_duration`
- :attr:`~AuditLogDiff.invitable`
.. versionadded:: 2.0
.. attribute:: thread_update
A thread was updated.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Thread` or :class:`Object` with the ID of the thread which
was updated.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.archived`
- :attr:`~AuditLogDiff.locked`
- :attr:`~AuditLogDiff.auto_archive_duration`
- :attr:`~AuditLogDiff.invitable`
.. versionadded:: 2.0
.. attribute:: thread_delete
A thread was deleted.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
the :class:`Thread` or :class:`Object` with the ID of the thread which
was deleted.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.name`
- :attr:`~AuditLogDiff.archived`
- :attr:`~AuditLogDiff.locked`
- :attr:`~AuditLogDiff.auto_archive_duration`
- :attr:`~AuditLogDiff.invitable`
.. versionadded:: 2.0
.. attribute:: application_command_permission_update
An application command's permissions were updated.
When this is the action, the type of :attr:`~AuditLogEntry.target` is
an :class:`Object` with the ID of the command that
had it's permissions edited.
Possible attributes for :class:`AuditLogDiff`:
- :attr:`~AuditLogDiff.command_id`
.. versionadded:: 2.0
Represents the category that the :class:`AuditLogAction` belongs to.
This can be retrieved via :attr:`AuditLogEntry.category`.
.. attribute:: create
The action is the creation of something.
.. attribute:: delete
The action is the deletion of something.
.. attribute:: update
The action is the update of something.
Represents the membership state of a team member retrieved through :func:`Client.application_info`.
.. versionadded:: 1.3
.. attribute:: invited
Represents an invited member.
.. attribute:: accepted
Represents a member currently in the team.
Represents the type of webhook that can be received.
.. versionadded:: 1.3
.. attribute:: incoming
Represents a webhook that can post messages to channels with a token.
.. attribute:: channel_follower
Represents a webhook that is internally managed by Discord, used for following channels.
.. attribute:: application
Represents a webhook that is used for interactions or applications.
.. versionadded:: 2.0
Represents the behaviour the :class:`Integration` should perform when a user's subscription has finished.
There is an alias for this called ExpireBehavior.
.. versionadded:: 1.4
.. attribute:: remove_role
This will remove the :attr:`StreamIntegration.role` from the user
when their subscription is finished.
.. attribute:: kick
This will kick the user when their subscription is finished.
Represents the default avatar of a Discord :class:`User`
.. attribute:: blurple
Represents the default avatar with the color blurple.
See also :attr:`Colour.blurple`
.. attribute:: grey
Represents the default avatar with the color grey.
See also :attr:`Colour.greyple`
.. attribute:: gray
An alias for :attr:`grey`.
.. attribute:: green
Represents the default avatar with the color green.
See also :attr:`Colour.green`
.. attribute:: orange
Represents the default avatar with the color orange.
See also :attr:`Colour.orange`
.. attribute:: red
Represents the default avatar with the color red.
See also :attr:`Colour.red`
Represents the type of sticker.
.. versionadded:: 2.0
.. attribute:: standard
Represents a standard sticker that all Nitro users can use.
.. attribute:: guild
Represents a custom sticker created in a guild.
Represents the type of sticker images.
.. versionadded:: 1.6
.. attribute:: png
Represents a sticker with a png image.
.. attribute:: apng
Represents a sticker with an apng image.
.. attribute:: lottie
Represents a sticker with a lottie image.
Represents the invite type for voice channel invites.
.. versionadded:: 2.0
.. attribute:: unknown
The invite doesn't target anyone or anything.
.. attribute:: stream
A stream invite that targets a user.
.. attribute:: 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.
.. versionadded:: 2.0
.. attribute:: auto
Represents auto camera video quality.
.. attribute:: 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.
.. versionadded:: 2.0
.. attribute:: closed
The stage instance can only be joined by members of the guild.
.. attribute:: guild_only
Alias for :attr:`.closed`
Represents the NSFW level of a guild.
.. versionadded:: 2.0
.. describe:: x == y
Checks if two NSFW levels are equal.
.. describe:: x != y
Checks if two NSFW levels are not equal.
.. describe:: x > y
Checks if a NSFW level is higher than another.
.. describe:: x < y
Checks if a NSFW level is lower than another.
.. describe:: x >= y
Checks if a NSFW level is higher or equal to another.
.. describe:: x <= y
Checks if a NSFW level is lower or equal to another.
.. attribute:: default
The guild has not been categorised yet.
.. attribute:: explicit
The guild contains NSFW content.
.. attribute:: safe
The guild does not contain any NSFW content.
.. attribute:: 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.
.. versionadded:: 2.0
.. attribute:: awkword
Represents the embedded application Awkword.
.. attribute:: betrayal
Represents the embedded application Betrayal.io
.. attribute:: checkers_in_the_park
Represents the embedded application Checkers in the Park Prod.
.. attribute:: checkers_in_the_park_dev
Represents the embedded application Checkers in the Park Development.
.. attribute:: checkers_in_the_park_staging
Represents the embedded application Checkers in the Park Staging.
.. attribute:: checkers_in_the_park_qa
Represents the embedded application Checkers in the Park QA.
.. attribute:: chess_in_the_park
Represents the embedded application Chess in the Park.
.. attribute:: chess_in_the_park_dev
Represents the embedded application Chess in the Park Development.
.. attribute:: chest_in_the_park_staging
Represents the embedded application Chess in the Park Staging.
.. attribute:: chest_in_the_park_qa
Represents the embedded application Chess in the Park QA.
.. attribute:: doodle_crew
Represents the embedded application Doodle Crew.
.. attribute:: fishington
Represents the embedded application Fishington.io
.. attribute:: letter_tile
Represents the embedded application Letter Tile.
.. attribute:: ocho
Represents the embedded application Ocho.
.. attribute:: ocho_dev
Represents the embedded application Ocho Development.
.. attribute:: ocho_staging
Represents the embedded application Ocho Staging.
.. attribute:: ocho_qa
Represents the embedded application Ocho QA.
.. attribute:: poker_night_staging
Represents the embedded application Poker Night Staging.
.. attribute:: poker_night
Represents the embedded application Poker Night.
.. attribute:: poker_night_qa
Represents the embedded application Poker QA.
.. attribute:: putts
Represents the embedded application Putts.
.. attribute:: sketchy_artist
Represents the embedded application Sketchy Artist.
.. attribute:: sketchy_artist_dev
Represents the embedded application Sketchy Artist development version.
.. attribute:: spell_cast
Represents the embedded application Spell Cast.
.. attribute:: watch_together
Same as :attr:`~EmbeddedActivity.youtube_together` with remote feature which allows guild admins to limit the playlist access.
.. attribute:: watch_together_dev
Development version of :attr:`.watch_together`.
.. attribute:: word_snacks
Represents the embedded application word snacks.
.. attribute:: word_snacks_dev
Represents the embedded application word snacks. This is development version of :attr:`.word_snacks`
.. attribute:: youtube_together
Represents the embedded application Youtube Together.
Represents the status of a scheduled event.
.. versionadded:: 2.0
.. attribute:: scheduled
The scheduled event hasn't started or been canceled yet.
.. attribute:: active
The scheduled event is in progress.
.. attribute:: completed
The scheduled event is over.
.. attribute:: canceled
The scheduled event has been canceled before it can start.
.. attribute:: cancelled
Alias to :attr:`canceled`.
Represents a scheduled event location type (otherwise known as the entity type on the API).
.. versionadded:: 2.0
.. attribute:: stage_instance
Represents a scheduled event that is happening in a :class:`StageChannel`.
.. attribute:: voice
Represents a scheduled event that is happening in a :class:`VoiceChannel`.
.. attribute:: external
Represents a generic location as a :class:`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.
.. attribute:: guild_only
Represents a scheduled event that is only available to members inside the guild.
Some API functions return an "async iterator". An async iterator is something that is capable of being used in an :ref:`async for statement <py:async for>`.
These async iterators can be used as follows:
async for elem in channel.history():
# do stuff with elem here
Certain utilities make working with async iterators easier, detailed below.
Represents the "AsyncIterator" concept. Note that no such class exists, it is purely abstract.
.. describe:: async for x in y
Iterates over the contents of the async iterator.
.. method:: next()
:async:
|coro|
Advances the iterator by one, if possible. If no more items are found
then this raises :exc:`NoMoreItems`.
.. method:: get(**attrs)
:async:
|coro|
Similar to :func:`utils.get` except run over the async iterator.
Getting the last message by a user named 'Dave' or ``None``: ::
msg = await channel.history().get(author__name='Dave')
.. method:: find(predicate)
:async:
|coro|
Similar to :func:`utils.find` except run over the async iterator.
Unlike :func:`utils.find`\, the predicate provided can be a
|coroutine_link|_.
Getting the last audit log with a reason or ``None``: ::
def predicate(event):
return event.reason is not None
event = await guild.audit_logs().find(predicate)
:param predicate: The predicate to use. Could be a |coroutine_link|_.
:return: The first element that returns ``True`` for the predicate or ``None``.
.. method:: flatten()
:async:
|coro|
Flattens the async iterator into a :class:`list` with all the elements.
:return: A list of every element in the async iterator.
:rtype: list
.. method:: chunk(max_size)
Collects items into chunks of up to a given maximum size.
Another :class:`AsyncIterator` is returned which collects items into
:class:`list`\s of a given size. The maximum chunk size must be a positive integer.
.. versionadded:: 1.6
Collecting groups of users: ::
async for leader, *users in reaction.users().chunk(3):
...
.. warning::
The last chunk collected may not be as large as ``max_size``.
:param max_size: The size of individual chunks.
:rtype: :class:`AsyncIterator`
.. method:: map(func)
This is similar to the built-in :func:`map <py:map>` function. Another
:class:`AsyncIterator` is returned that executes the function on
every element it is iterating over. This function can either be a
regular function or a |coroutine_link|_.
Creating a content iterator: ::
def transform(message):
return message.content
async for content in channel.history().map(transform):
message_length = len(content)
:param func: The function to call on every element. Could be a |coroutine_link|_.
:rtype: :class:`AsyncIterator`
.. method:: filter(predicate)
This is similar to the built-in :func:`filter <py:filter>` function. Another
:class:`AsyncIterator` is returned that filters over the original
async iterator. This predicate can be a regular function or a |coroutine_link|_.
Getting messages by non-bot accounts: ::
def predicate(message):
return not message.author.bot
async for elem in channel.history().filter(predicate):
...
:param predicate: The predicate to call on every element. Could be a |coroutine_link|_.
:rtype: :class:`AsyncIterator`
Working with :meth:`Guild.audit_logs` is a complicated process with a lot of machinery involved. The library attempts to make it easy to use and friendly. In order to accomplish this goal, it must make use of a couple of data classes that aid in this goal.
.. attributetable:: AuditLogEntry
.. autoclass:: AuditLogEntry
:members:
.. attributetable:: AuditLogChanges
An audit log change set.
.. attribute:: before
The old value. The attribute has the type of :class:`AuditLogDiff`.
Depending on the :class:`AuditLogActionCategory` retrieved by
:attr:`~AuditLogEntry.category`\, the data retrieved by this
attribute differs:
+----------------------------------------+---------------------------------------------------+
| Category | Description |
+----------------------------------------+---------------------------------------------------+
| :attr:`~AuditLogActionCategory.create` | All attributes are set to ``None``. |
+----------------------------------------+---------------------------------------------------+
| :attr:`~AuditLogActionCategory.delete` | All attributes are set the value before deletion. |
+----------------------------------------+---------------------------------------------------+
| :attr:`~AuditLogActionCategory.update` | All attributes are set the value before updating. |
+----------------------------------------+---------------------------------------------------+
| ``None`` | No attributes are set. |
+----------------------------------------+---------------------------------------------------+
.. attribute:: after
The new value. The attribute has the type of :class:`AuditLogDiff`.
Depending on the :class:`AuditLogActionCategory` retrieved by
:attr:`~AuditLogEntry.category`\, the data retrieved by this
attribute differs:
+----------------------------------------+--------------------------------------------------+
| Category | Description |
+----------------------------------------+--------------------------------------------------+
| :attr:`~AuditLogActionCategory.create` | All attributes are set to the created value |
+----------------------------------------+--------------------------------------------------+
| :attr:`~AuditLogActionCategory.delete` | All attributes are set to ``None`` |
+----------------------------------------+--------------------------------------------------+
| :attr:`~AuditLogActionCategory.update` | All attributes are set the value after updating. |
+----------------------------------------+--------------------------------------------------+
| ``None`` | No attributes are set. |
+----------------------------------------+--------------------------------------------------+
.. attributetable:: AuditLogDiff
Represents an audit log "change" object. A change object has dynamic attributes that depend on the type of action being done. Certain actions map to certain attributes being set.
Note that accessing an attribute that does not match the specified action will lead to an attribute error.
To get a list of attributes that have been set, you can iterate over them. To see a list of all possible attributes that could be set based on the action being done, check the documentation for :class:`AuditLogAction`, otherwise check the documentation below for all attributes that are possible.
.. describe:: iter(diff)
Returns an iterator over (attribute, value) tuple of this diff.
.. attribute:: name
A name of something.
:type: :class:`str`
.. attribute:: icon
A guild's icon. See also :attr:`Guild.icon`.
:type: :class:`Asset`
.. attribute:: splash
The guild's invite splash. See also :attr:`Guild.splash`.
:type: :class:`Asset`
.. attribute:: discovery_splash
The guild's discovery splash. See also :attr:`Guild.discovery_splash`.
:type: :class:`Asset`
.. attribute:: banner
The guild's banner. See also :attr:`Guild.banner`.
:type: :class:`Asset`
.. attribute:: owner
The guild's owner. See also :attr:`Guild.owner`
:type: Union[:class:`Member`, :class:`User`]
.. attribute:: region
The guild's voice region. See also :attr:`Guild.region`.
:type: :class:`VoiceRegion`
.. attribute:: afk_channel
The guild's AFK channel.
If this could not be found, then it falls back to a :class:`Object`
with the ID being set.
See :attr:`Guild.afk_channel`.
:type: Union[:class:`VoiceChannel`, :class:`Object`]
.. attribute:: system_channel
The guild's system channel.
If this could not be found, then it falls back to a :class:`Object`
with the ID being set.
See :attr:`Guild.system_channel`.
:type: Union[:class:`TextChannel`, :class:`Object`]
.. attribute:: rules_channel
The guild's rules channel.
If this could not be found then it falls back to a :class:`Object`
with the ID being set.
See :attr:`Guild.rules_channel`.
:type: Union[:class:`TextChannel`, :class:`Object`]
.. attribute:: public_updates_channel
The guild's public updates channel.
If this could not be found then it falls back to a :class:`Object`
with the ID being set.
See :attr:`Guild.public_updates_channel`.
:type: Union[:class:`TextChannel`, :class:`Object`]
.. attribute:: afk_timeout
The guild's AFK timeout. See :attr:`Guild.afk_timeout`.
:type: :class:`int`
.. attribute:: mfa_level
The guild's MFA level. See :attr:`Guild.mfa_level`.
:type: :class:`int`
.. attribute:: widget_enabled
The guild's widget has been enabled or disabled.
:type: :class:`bool`
.. attribute:: widget_channel
The widget's channel.
If this could not be found then it falls back to a :class:`Object`
with the ID being set.
:type: Union[:class:`TextChannel`, :class:`Object`]
.. attribute:: verification_level
The guild's verification level.
See also :attr:`Guild.verification_level`.
:type: :class:`VerificationLevel`
.. attribute:: default_notifications
The guild's default notification level.
See also :attr:`Guild.default_notifications`.
:type: :class:`NotificationLevel`
.. attribute:: explicit_content_filter
The guild's content filter.
See also :attr:`Guild.explicit_content_filter`.
:type: :class:`ContentFilter`
.. attribute:: default_message_notifications
The guild's default message notification setting.
:type: :class:`int`
.. attribute:: vanity_url_code
The guild's vanity URL.
See also :meth:`Guild.vanity_invite` and :meth:`Guild.edit`.
:type: :class:`str`
.. attribute:: position
The position of a :class:`Role` or :class:`abc.GuildChannel`.
:type: :class:`int`
.. attribute:: type
The type of channel or sticker.
:type: Union[:class:`ChannelType`, :class:`StickerType`]
.. attribute:: topic
The topic of a :class:`TextChannel` or :class:`StageChannel`.
See also :attr:`TextChannel.topic` or :attr:`StageChannel.topic`.
:type: :class:`str`
.. attribute:: bitrate
The bitrate of a :class:`VoiceChannel`.
See also :attr:`VoiceChannel.bitrate`.
:type: :class:`int`
.. attribute:: overwrites
A list of permission overwrite tuples that represents a target and a
:class:`PermissionOverwrite` for said target.
The first element is the object being targeted, which can either
be a :class:`Member` or :class:`User` or :class:`Role`. If this object
is not found then it is a :class:`Object` with an ID being filled and
a ``type`` attribute set to either ``'role'`` or ``'member'`` to help
decide what type of ID it is.
:type: List[Tuple[target, :class:`PermissionOverwrite`]]
.. attribute:: privacy_level
The privacy level of the stage instance or scheduled event.
:type: :class:`StagePrivacyLevel` or :class:`ScheduledEventPrivacyLevel`
.. attribute:: roles
A list of roles being added or removed from a member.
If a role is not found then it is a :class:`Object` with the ID and name being
filled in.
:type: List[Union[:class:`Role`, :class:`Object`]]
.. attribute:: nick
The nickname of a member.
See also :attr:`Member.nick`
:type: Optional[:class:`str`]
.. attribute:: deaf
Whether the member is being server deafened.
See also :attr:`VoiceState.deaf`.
:type: :class:`bool`
.. attribute:: mute
Whether the member is being server muted.
See also :attr:`VoiceState.mute`.
:type: :class:`bool`
.. attribute:: permissions
The permissions of a role.
See also :attr:`Role.permissions`.
:type: :class:`Permissions`
.. attribute:: colour
color
The colour of a role.
See also :attr:`Role.colour`
:type: :class:`Colour`
.. attribute:: hoist
Whether the role is being hoisted or not.
See also :attr:`Role.hoist`
:type: :class:`bool`
.. attribute:: mentionable
Whether the role is mentionable or not.
See also :attr:`Role.mentionable`
:type: :class:`bool`
.. attribute:: code
The invite's code.
See also :attr:`Invite.code`
:type: :class:`str`
.. attribute:: channel
A guild channel.
If the channel is not found then it is a :class:`Object` with the ID
being set. In some cases the channel name is also set.
:type: Union[:class:`abc.GuildChannel`, :class:`Object`]
.. attribute:: inviter
The user who created the invite.
See also :attr:`Invite.inviter`.
:type: Optional[:class:`User`]
.. attribute:: max_uses
The invite's max uses.
See also :attr:`Invite.max_uses`.
:type: :class:`int`
.. attribute:: uses
The invite's current uses.
See also :attr:`Invite.uses`.
:type: :class:`int`
.. attribute:: max_age
The invite's max age in seconds.
See also :attr:`Invite.max_age`.
:type: :class:`int`
.. attribute:: temporary
If the invite is a temporary invite.
See also :attr:`Invite.temporary`.
:type: :class:`bool`
.. attribute:: allow
deny
The permissions being allowed or denied.
:type: :class:`Permissions`
.. attribute:: id
The ID of the object being changed.
:type: :class:`int`
.. attribute:: avatar
The avatar of a member.
See also :attr:`User.avatar`.
:type: :class:`Asset`
.. attribute:: slowmode_delay
The number of seconds members have to wait before
sending another message in the channel.
See also :attr:`TextChannel.slowmode_delay`.
:type: :class:`int`
.. attribute:: rtc_region
The region for the voice channel’s voice communication.
A value of ``None`` indicates automatic voice region detection.
See also :attr:`VoiceChannel.rtc_region`.
:type: :class:`VoiceRegion`
.. attribute:: video_quality_mode
The camera video quality for the voice channel's participants.
See also :attr:`VoiceChannel.video_quality_mode`.
:type: :class:`VideoQualityMode`
.. attribute:: format_type
The format type of a sticker being changed.
See also :attr:`GuildSticker.format`
:type: :class:`StickerFormatType`
.. attribute:: emoji
The name of the emoji that represents a sticker being changed.
See also :attr:`GuildSticker.emoji`
:type: :class:`str`
.. attribute:: description
The description of a sticker being changed.
See also :attr:`GuildSticker.description`
:type: :class:`str`
.. attribute:: available
The availability of a sticker being changed.
See also :attr:`GuildSticker.available`
:type: :class:`bool`
.. attribute:: archived
The thread is now archived.
:type: :class:`bool`
.. attribute:: locked
The thread is being locked or unlocked.
:type: :class:`bool`
.. attribute:: auto_archive_duration
The thread's auto archive duration being changed.
See also :attr:`Thread.auto_archive_duration`
:type: :class:`int`
.. attribute:: default_auto_archive_duration
The default auto archive duration for newly created threads being changed.
:type: :class:`int`
.. attribute:: invitable
Non-moderators can now add other non-moderators to this thread.
:type: :class:`bool`
.. attribute:: command_id
This command's permissions were updated.
:type: :class:`int`
Pycord offers support for creating, editing, and executing webhooks through the :class:`Webhook` class.
.. attributetable:: Webhook
.. autoclass:: Webhook()
:members:
:inherited-members:
.. attributetable:: WebhookMessage
.. autoclass:: WebhookMessage()
:members:
.. attributetable:: SyncWebhook
.. autoclass:: SyncWebhook()
:members:
:inherited-members:
.. attributetable:: SyncWebhookMessage
.. autoclass:: SyncWebhookMessage()
:members:
An :term:`abstract base class` (also known as an abc) is a class that models can inherit
to get their behaviour. Abstract base classes should not be instantiated.
They are mainly there for usage with :func:`isinstance` and :func:`issubclass`.
This library has a module related to abstract base classes, in which all the ABCs are subclasses of :class:`typing.Protocol`.
.. attributetable:: discord.abc.Snowflake
.. autoclass:: discord.abc.Snowflake()
:members:
.. attributetable:: discord.abc.User
.. autoclass:: discord.abc.User()
:members:
.. attributetable:: discord.abc.PrivateChannel
.. autoclass:: discord.abc.PrivateChannel()
:members:
.. attributetable:: discord.abc.GuildChannel
.. autoclass:: discord.abc.GuildChannel()
:members:
.. attributetable:: discord.abc.Messageable
.. autoclass:: discord.abc.Messageable()
:members:
:exclude-members: history, typing
.. automethod:: discord.abc.Messageable.history
:async-for:
.. automethod:: discord.abc.Messageable.typing
:async-with:
.. attributetable:: discord.abc.Connectable
.. autoclass:: discord.abc.Connectable()
Models are classes that are received from Discord and are not meant to be created by the user of the library.
!DANGER!
The classes listed below are not intended to be created by users and are also read-only.
For example, this means that you should not make your own :class:`User` instances nor should you modify the :class:`User` instance yourself.
If you want to get one of these model classes instances they'd have to be through the cache, and a common way of doing so is through the :func:`utils.find` function or attributes of model classes that you receive from the events specified in the :ref:`discord-api-events`.
Note
Nearly all classes here have :ref:`py:slots` defined which means that it is impossible to have dynamic attributes to the data classes.
.. attributetable:: ClientUser
.. autoclass:: ClientUser()
:members:
:inherited-members:
.. attributetable:: User
.. autoclass:: User()
:members:
:inherited-members:
:exclude-members: history, typing
.. automethod:: history
:async-for:
.. automethod:: typing
:async-with:
.. attributetable:: Attachment
.. autoclass:: Attachment()
:members:
.. attributetable:: Asset
.. autoclass:: Asset()
:members:
:inherited-members:
.. attributetable:: Message
.. autoclass:: Message()
:members:
.. attributetable:: Component
.. autoclass:: Component()
:members:
.. attributetable:: ActionRow
.. autoclass:: ActionRow()
:members:
.. attributetable:: Button
.. autoclass:: Button()
:members:
:inherited-members:
.. attributetable:: SelectMenu
.. autoclass:: SelectMenu()
:members:
:inherited-members:
.. attributetable:: DeletedReferencedMessage
.. autoclass:: DeletedReferencedMessage()
:members:
.. attributetable:: Reaction
.. autoclass:: Reaction()
:members:
:exclude-members: users
.. automethod:: users
:async-for:
.. attributetable:: Guild
.. autoclass:: Guild()
:members:
:exclude-members: fetch_members, audit_logs
.. automethod:: fetch_members
:async-for:
.. automethod:: audit_logs
:async-for:
A namedtuple which represents a ban returned from :meth:`~Guild.bans`.
.. attribute:: reason
The reason this user was banned.
:type: Optional[:class:`str`]
.. attribute:: user
The :class:`User` that was banned.
:type: :class:`User`
.. attributetable:: ScheduledEvent
.. autoclass:: ScheduledEvent()
:members:
.. autoclass:: ScheduledEventLocation()
:members:
.. autoclass:: Integration()
:members:
.. autoclass:: IntegrationAccount()
:members:
.. autoclass:: BotIntegration()
:members:
.. autoclass:: IntegrationApplication()
:members:
.. autoclass:: StreamIntegration()
:members:
.. attributetable:: Interaction
.. autoclass:: Interaction()
:members:
.. attributetable:: InteractionResponse
.. autoclass:: InteractionResponse()
:members:
.. attributetable:: InteractionMessage
.. autoclass:: InteractionMessage()
:members:
.. attributetable:: MessageInteraction
.. autoclass:: MessageInteraction()
:members:
.. attributetable:: Member
.. autoclass:: Member()
:members:
:inherited-members:
:exclude-members: history, typing
.. automethod:: history
:async-for:
.. automethod:: typing
:async-with:
.. attributetable:: Spotify
.. autoclass:: Spotify()
:members:
.. attributetable:: VoiceState
.. autoclass:: VoiceState()
:members:
.. attributetable:: Emoji
.. autoclass:: Emoji()
:members:
:inherited-members:
.. attributetable:: PartialEmoji
.. autoclass:: PartialEmoji()
:members:
:inherited-members:
.. attributetable:: Role
.. autoclass:: Role()
:members:
.. attributetable:: RoleTags
.. autoclass:: RoleTags()
:members:
.. attributetable:: PartialMessageable
.. autoclass:: PartialMessageable()
:members:
:inherited-members:
.. attributetable:: TextChannel
.. autoclass:: TextChannel()
:members:
:inherited-members:
:exclude-members: history, typing
.. automethod:: history
:async-for:
.. automethod:: typing
:async-with:
.. attributetable:: Thread
.. autoclass:: Thread()
:members:
:inherited-members:
:exclude-members: history, typing
.. automethod:: history
:async-for:
.. automethod:: typing
:async-with:
.. attributetable:: ThreadMember
.. autoclass:: ThreadMember()
:members:
.. attributetable:: VoiceChannel
.. autoclass:: VoiceChannel()
:members:
:inherited-members:
.. attributetable:: StageChannel
.. autoclass:: StageChannel()
:members:
:inherited-members:
.. attributetable:: StageInstance
.. autoclass:: StageInstance()
:members:
.. attributetable:: CategoryChannel
.. autoclass:: CategoryChannel()
:members:
:inherited-members:
.. attributetable:: DMChannel
.. autoclass:: DMChannel()
:members:
:inherited-members:
:exclude-members: history, typing
.. automethod:: history
:async-for:
.. automethod:: typing
:async-with:
.. attributetable:: GroupChannel
.. autoclass:: GroupChannel()
:members:
:inherited-members:
:exclude-members: history, typing
.. automethod:: history
:async-for:
.. automethod:: typing
:async-with:
.. attributetable:: PartialInviteGuild
.. autoclass:: PartialInviteGuild()
:members:
.. attributetable:: PartialInviteChannel
.. autoclass:: PartialInviteChannel()
:members:
.. attributetable:: Invite
.. autoclass:: Invite()
:members:
.. attributetable:: Template
.. autoclass:: Template()
:members:
.. attributetable:: WelcomeScreen
.. autoclass:: WelcomeScreen()
:members:
.. attributetable:: WelcomeScreenChannel
.. autoclass:: WelcomeScreenChannel()
:members:
.. attributetable:: WidgetChannel
.. autoclass:: WidgetChannel()
:members:
.. attributetable:: WidgetMember
.. autoclass:: WidgetMember()
:members:
:inherited-members:
.. attributetable:: Widget
.. autoclass:: Widget()
:members:
.. attributetable:: StickerPack
.. autoclass:: StickerPack()
:members:
.. attributetable:: StickerItem
.. autoclass:: StickerItem()
:members:
.. attributetable:: Sticker
.. autoclass:: Sticker()
:members:
.. attributetable:: StandardSticker
.. autoclass:: StandardSticker()
:members:
.. attributetable:: GuildSticker
.. autoclass:: GuildSticker()
:members:
.. attributetable:: RawTypingEvent
.. autoclass:: RawTypingEvent()
:members:
.. attributetable:: RawMessageDeleteEvent
.. autoclass:: RawMessageDeleteEvent()
:members:
.. attributetable:: RawBulkMessageDeleteEvent
.. autoclass:: RawBulkMessageDeleteEvent()
:members:
.. attributetable:: RawMessageUpdateEvent
.. autoclass:: RawMessageUpdateEvent()
:members:
.. attributetable:: RawReactionActionEvent
.. autoclass:: RawReactionActionEvent()
:members:
.. attributetable:: RawReactionClearEvent
.. autoclass:: RawReactionClearEvent()
:members:
.. attributetable:: RawReactionClearEmojiEvent
.. autoclass:: RawReactionClearEmojiEvent()
:members:
.. attributetable:: RawIntegrationDeleteEvent
.. autoclass:: RawIntegrationDeleteEvent()
:members:
.. attributetable:: RawThreadDeleteEvent
.. autoclass:: RawThreadDeleteEvent()
:members:
.. attributetable:: RawScheduledEventSubscription
.. autoclass:: RawScheduledEventSubscription()
:members:
.. attributetable:: PartialWebhookGuild
.. autoclass:: PartialWebhookGuild()
:members:
.. attributetable:: PartialWebhookChannel
.. autoclass:: PartialWebhookChannel()
:members:
Some classes are just there to be data containers, this lists them.
Unlike :ref:`models <discord_api_models>` you are allowed to create most of these yourself, even if they can also be used to hold attributes.
Nearly all classes here have :ref:`py:slots` defined which means that it is impossible to have dynamic attributes to the data classes.
The only exception to this rule is :class:`Object`, which is made with dynamic attributes in mind.
.. attributetable:: Object
.. autoclass:: Object
:members:
.. attributetable:: Embed
.. autoclass:: Embed
:members:
.. attributetable:: EmbedField
.. autoclass:: EmbedField
:members:
.. attributetable:: AllowedMentions
.. autoclass:: AllowedMentions
:members:
.. attributetable:: MessageReference
.. autoclass:: MessageReference
:members:
.. attributetable:: PartialMessage
.. autoclass:: PartialMessage
:members:
.. attributetable:: SelectOption
.. autoclass:: SelectOption
:members:
.. attributetable:: Intents
.. autoclass:: Intents
:members:
.. attributetable:: MemberCacheFlags
.. autoclass:: MemberCacheFlags
:members:
.. attributetable:: ApplicationFlags
.. autoclass:: ApplicationFlags
:members:
.. attributetable:: File
.. autoclass:: File
:members:
.. attributetable:: Colour
.. autoclass:: Colour
:members:
.. attributetable:: BaseActivity
.. autoclass:: BaseActivity
:members:
.. attributetable:: Activity
.. autoclass:: Activity
:members:
.. attributetable:: Game
.. autoclass:: Game
:members:
.. attributetable:: Streaming
.. autoclass:: Streaming
:members:
.. attributetable:: CustomActivity
.. autoclass:: CustomActivity
:members:
.. attributetable:: Permissions
.. autoclass:: Permissions
:members:
.. attributetable:: PermissionOverwrite
.. autoclass:: PermissionOverwrite
:members:
.. attributetable:: ShardInfo
.. autoclass:: ShardInfo()
:members:
.. attributetable:: SystemChannelFlags
.. autoclass:: SystemChannelFlags()
:members:
.. attributetable:: MessageFlags
.. autoclass:: MessageFlags()
:members:
.. attributetable:: PublicUserFlags
.. autoclass:: PublicUserFlags()
:members:
The library has helpers to help create component-based UIs.
.. attributetable:: discord.ui.View
.. autoclass:: discord.ui.View
:members:
.. attributetable:: discord.ui.Item
.. autoclass:: discord.ui.Item
:members:
.. attributetable:: discord.ui.Button
.. autoclass:: discord.ui.Button
:members:
:inherited-members:
.. autofunction:: discord.ui.button
.. attributetable:: discord.ui.Select
.. autoclass:: discord.ui.Select
:members:
:inherited-members:
.. autofunction:: discord.ui.select
.. attributetable:: discord.ui.Modal
.. autoclass:: discord.ui.Modal
:members:
:inherited-members:
.. attributetable:: discord.ui.InputText
.. autoclass:: discord.ui.InputText
:members:
:inherited-members:
.. autoclass:: discord.sinks.Filters
:members:
.. autoclass:: discord.sinks.Sink
:members:
.. autoclass:: discord.sinks.AudioData
:members:
.. autoclass:: discord.sinks.RawData
:members:
.. autoclass:: discord.sinks.WaveSink
:members:
.. autoclass:: discord.sinks.MP3Sink
:members:
.. autoclass:: discord.sinks.MP4Sink
:members:
.. autoclass:: discord.sinks.M4ASink
:members:
.. autoclass:: discord.sinks.MKVSink
:members:
.. autoclass:: discord.sinks.MKASink
:members:
.. autoclass:: discord.sinks.OGGSink
:members:
.. autoexception:: discord.sinks.SinkException
.. autoexception:: discord.sinks.RecordingException
.. autoexception:: discord.sinks.WaveSinkError
.. autoexception:: discord.sinks.MP3SinkError
.. autoexception:: discord.sinks.MP4SinkError
.. autoexception:: discord.sinks.M4ASinkError
.. autoexception:: discord.sinks.MKVSinkError
.. autoexception:: discord.sinks.MKASinkError
.. autoexception:: discord.sinks.OGGSinkError
.. exception_hierarchy::
- :exc:`DiscordException`
- :exc:`sinks.SinkException`
- :exc:`sinks.RecordingException`
- :exc:`sinks.WaveSinkError`
- :exc:`sinks.MP3SinkError`
- :exc:`sinks.MP4SinkError`
- :exc:`sinks.M4ASinkError`
- :exc:`sinks.MKVSinkError`
- :exc:`sinks.MKASinkError`
- :exc:`sinks.OGGSinkError`
The following exceptions are thrown by the library.
.. autoexception:: DiscordException
.. autoexception:: ClientException
.. autoexception:: LoginFailure
.. autoexception:: NoMoreItems
.. autoexception:: HTTPException
:members:
.. autoexception:: Forbidden
.. autoexception:: NotFound
.. autoexception:: DiscordServerError
.. autoexception:: InvalidData
.. autoexception:: InvalidArgument
.. autoexception:: GatewayNotFound
.. autoexception:: ConnectionClosed
.. autoexception:: PrivilegedIntentsRequired
.. autoexception:: InteractionResponded
.. autoexception:: discord.opus.OpusError
.. autoexception:: discord.opus.OpusNotLoaded
.. autoexception:: discord.ApplicationCommandError
:members:
.. autoexception:: discord.CheckFailure
:members:
.. autoexception:: discord.ApplicationCommandInvokeError
:members:
.. autoexception:: discord.ExtensionError
:members:
.. autoexception:: discord.ExtensionAlreadyLoaded
:members:
.. autoexception:: discord.ExtensionNotLoaded
:members:
.. autoexception:: discord.NoEntryPointError
:members:
.. autoexception:: discord.ExtensionFailed
:members:
.. autoexception:: discord.ExtensionNotFound
:members:
.. exception_hierarchy::
- :exc:`Exception`
- :exc:`DiscordException`
- :exc:`ClientException`
- :exc:`InvalidData`
- :exc:`InvalidArgument`
- :exc:`LoginFailure`
- :exc:`ConnectionClosed`
- :exc:`PrivilegedIntentsRequired`
- :exc:`InteractionResponded`
- :exc:`NoMoreItems`
- :exc:`GatewayNotFound`
- :exc:`HTTPException`
- :exc:`Forbidden`
- :exc:`NotFound`
- :exc:`DiscordServerError`
- :exc:`ApplicationCommandError`
- :exc:`CheckFailure`
- :exc:`ApplicationCommandInvokeError`
- :exc:`ExtensionError`
- :exc:`ExtensionAlreadyLoaded`
- :exc:`ExtensionNotLoaded`
- :exc:`NoEntryPointError`
- :exc:`ExtensionFailed`
- :exc:`ExtensionNotFound`