Audit Log Data#

Working with 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.

Attributes

action
after
before
category
changes
created_at
extra
id
reason
target
user

class discord.AuditLogEntry(*, users, data, guild)[source]#

Represents an Audit Log entry.

You retrieve these via Guild.audit_logs().

x == y: Checks if two entries are equal.

x != y: Checks if two entries are not equal.

hash(x): Returns the entry’s hash.

Changed in version 1.7: Audit log entries are now comparable and hashable.

action#

The action that was done.

Type:: AuditLogAction

user#

The user who initiated this action. Usually a Member, unless gone then it’s a User.

Type:: Optional[abc.User]

id#

The entry ID.

Type:: int

target#

The target that got changed. The exact type of this depends on the action being done.

Type:: Any

reason#

The reason this action was done.

Type:: Optional[str]

extra#

Extra information that this entry has that might be useful. For most actions, this is None. However, in some cases it contains extra information. See AuditLogAction for which actions have this field filled out.

Type:: Any

created_at#: Returns the entry’s creation time in UTC.

category#: The category of the action, if applicable.

changes#: The list of changes this entry has.

before#: The target’s prior state.

after#: The target’s subsequent state.

Attributes

after
before

class discord.AuditLogChanges[source]#

An audit log change set.

before#

The old value. The attribute has the type of AuditLogDiff.

Depending on the AuditLogActionCategory retrieved by category, the data retrieved by this attribute differs:

Category	Description
`create`	All attributes are set to `None`.
`delete`	All attributes are set the value before deletion.
`update`	All attributes are set the value before updating.
`None`	No attributes are set.

after#

The new value. The attribute has the type of AuditLogDiff.

Depending on the AuditLogActionCategory retrieved by category, the data retrieved by this attribute differs:

Category	Description
`create`	All attributes are set to the created value
`delete`	All attributes are set to `None`
`update`	All attributes are set the value after updating.
`None`	No attributes are set.

class discord.AuditLogDiff[source]#

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 AuditLogAction, otherwise check the documentation below for all attributes that are possible.