Audit Logs — Events Reference

Audit Logs — Events Reference

📘

Enterprise feature.

Audit Logs are only available to workspaces on the Enterprise plan.

This page lists all events currently emitted by Dust.


Agents

EventDescription
agent.createdAn agent was created
agent.updatedAn agent's configuration was updated
agent.archivedAn agent was archived
agent.restoredAn archived agent was restored
agent.scope_changedAn agent's visibility scope was changed (e.g. private → workspace)
agent.executedAn agent was invoked in a conversation

Tools

EventDescription
tool.executedA tool was executed by an agent; metadata includes the tool name, MCP server name, data sources accessed, and whether the action was AI-driven or directly user-initiated

Triggers

EventDescription
trigger.createdA trigger was created
trigger.deletedA trigger was deleted
trigger.enabledA trigger was enabled
trigger.disabledA trigger was disabled
trigger.firedA trigger fired and initiated an agent run
trigger.email_receivedAn inbound email was received by a trigger

Wake-ups

EventDescription
wake_up.cancelledA wake-up was cancelled
wake_up.createdA wake-up was created
wake_up.expiredA wake-up expired
wake_up.firedA wake-up fired

Spaces

EventDescription
space.createdA space was created
space.deletedA space was deleted
space.accessedA space was accessed
space.permissions_updatedA space's permissions were modified

Data Sources

EventDescription
datasource.createdA data source was created
datasource.updatedA data source's configuration was updated
datasource.deletedA data source was deleted
datasource.deleted_adminA data source was deleted by an admin
datasource.reauthorizedA data source's OAuth credentials were reauthorized

Members & Memberships

EventDescription
member.invitedA member was invited to the workspace
member.bulk_invitedMultiple members were invited in bulk
member.bulk_revokedMultiple members were revoked in bulk
membership.createdA workspace membership was created
membership.revokedA workspace membership was revoked
membership.role_updatedA member's role was changed
membership.origin_updatedThe origin of a membership was updated (e.g. manual → SCIM)

Invitations

EventDescription
invitation.revokedA pending invitation was revoked
invitation.role_updatedThe role assigned to a pending invitation was changed

Users

EventDescription
user.loginA user logged in
user.login_failedA login attempt failed
user.logoutA user logged out
user.identity_mergedTwo user identities were merged
user.relocatedA user was relocated to a different workspace

API Keys

EventDescription
api_key.createdAn API key was created
api_key.updatedAn API key was updated
api_key.revokedAn API key was revoked

OAuth

EventDescription
oauth.initiatedAn OAuth authorization flow was started
oauth.authorizedAn OAuth authorization was completed
oauth.revokedAn OAuth token was revoked

MCP Connections

EventDescription
mcp_connection.createdAn MCP server connection was established
mcp_connection.deletedAn MCP server connection was removed

Credentials (BYOK)

EventDescription
credentials.createdA credential set was created
credentials.updatedA credential set was updated
credentials.revokedA credential set was revoked
credentials.invalidatedA credential set was invalidated (e.g. provider-side expiry)

Domains

EventDescription
domain.removedA verified domain was removed from the workspace
domain.verifiedA domain was verified
domain.verification_failedA domain verification attempt failed

SSO & Directory Sync

EventDescription
sso.connection_deletedAn SSO connection was deleted
dsync.connection_deletedA Directory Sync connection was deleted
scim.user_provisionedA user was provisioned via SCIM
scim.user_updatedA SCIM-provisioned user's attributes were updated
scim.user_deprovisionedA user was deprovisioned via SCIM
scim.group_createdA group was created via SCIM
scim.group_deletedA group was deleted via SCIM
scim.group_user_addedA user was added to a SCIM group
scim.group_user_removedA user was removed from a SCIM group

Conversations

EventDescription
conversation.accessedA conversation was accessed

Audit Logs (Meta)

EventDescription
audit_log.viewedThe Audit Logs viewer was accessed by an admin
audit_log.export_configuredAn audit log export or log stream was configured

Workspace

EventDescription
workspace.deletedThe workspace was deleted