Skip to main content
Audit logs are available on Enterprise plans.
Use audit logs to monitor and track actions performed by members of your organization. Audit logs provide a record of activities for security, compliance, and troubleshooting purposes.
  • Monitor security: Track authentication attempts and permission changes.
  • Ensure compliance: Maintain records of all organizational activities.
  • Troubleshoot issues: Investigate failed actions and their causes.
  • Track changes: Review who made specific changes and when.

​
View audit logs

Only organization admins can view and export audit logs. Navigate to the Audit log page of your dashboard to view audit logs. Mintlify retains audit log entries for two years. Export logs to CSV to keep records for longer. Click any log entry to expand it and view detailed information, including:

​
Filter logs

Filter audit logs to find specific activities. Date range: Select a preset date range to view logs over a specific period. Category: Filter logs by the type of action.

​
Stream audit logs

Stream audit logs to Amazon S3 or Datadog in near real time. Use streaming to send audit events to your existing security monitoring and long-term retention systems without repeatedly exporting CSV files. Organization admins can add multiple destinations and choose which categories to send. By default, all categories stream, and the category selection applies to every configured destination.

​
Add a destination

  1. Navigate to the Audit log page of your dashboard.
  2. In the Audit log streaming section, click Configure.
  3. Click Add destination and select Amazon S3 or Datadog.
  4. Enter an optional label to identify the destination, then provide the required connection details:
  5. Click Add destination.
Create an IAM user (or role with programmatic access credentials) whose policy allows writing to the target bucket. At minimum, grant s3:PutObject on the bucket and key prefix that you plan to use. For example:
Use the access key ID and secret access key from that IAM user when adding the destination. The key prefix is optional and is prepended to every object that Mintlify writes.
Create a Datadog API key from Organization Settings > API Keys in your Datadog account. Do not use an application key.Set the Datadog site to match the region where your Datadog account is hosted, for example datadoghq.com (US1), us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu (EU1), ap1.datadoghq.com, or ddog-gov.com. Using the wrong site rejects the events.
To stop streaming to a destination, open the streaming configuration and click the remove icon next to the destination.

​
Select streamed categories

  1. Navigate to the Audit log page of your dashboard.
  2. In the Audit log streaming section, click Configure.
  3. Under Streamed categories, select the categories that you want to send. Clear a category to exclude its events from the stream.
  4. Click Save changes.

​
Export audit logs

Export audit logs to CSV for analysis, compliance reporting, or long-term archival.
  1. Navigate to the Audit log page of your dashboard.
  2. Optionally, apply filters to narrow down the logs you want to export.
  3. Click Export CSV.
  4. Mintlify sends you an email with a download link when the export is ready.