Skip to content

Add audit logs documentation#62

Draft
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/audit-logs-1775083035
Draft

Add audit logs documentation#62
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/audit-logs-1775083035

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 1, 2026

Summary

  • Adds a new enterprise documentation page covering Cal.com's audit logging system, which was introduced in calcom/cal#923
  • Documents 18 tracked events across security, access control, API keys, and workflows — including what each log entry contains and who can access it
  • Adds the new page to the Enterprise navigation group in docs.json

What shipped

Cal.com now automatically records an immutable audit trail for security-sensitive actions within enterprise organizations. This includes login events, password and 2FA changes, member and role management, API key lifecycle, and workflow changes. Each entry captures the actor, action, target, source, result, and timestamp.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 1, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
calcomhelp 🟢 Ready View Preview Apr 1, 2026, 10:41 PM


---

## How audit logging works
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section needs adjustment. Events are fire-and-forget (not written as part of the same operation). Also, currently audit events are being recorded in the database but there is no viewer/interface for customers to query them yet. Audit events are recorded automatically whenever a tracked action occurs.


- **Who** — the user who performed the action
- **What** — the specific action taken, along with previous and new values when applicable (e.g., a role change from Member to Admin)
- **Where** — the target resource (team, membership, API key, or workflow)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor: add "user" to the list — login, password change, 2FA, and email change events all target a user resource

@pedroccastro pedroccastro marked this pull request as draft April 2, 2026 18:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant