Audit logs

Review, export, and stream audit logs to Amazon S3 or Datadog to track deployments, configuration changes, and permission updates in your organization.

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 up to one year. You can view and export entries from the last 90 days. Export logs to CSV regularly to keep a longer record.

Click any log entry to open its details, including:

Field	Description
Timestamp	Date and time when the action occurred
Actor	The email address of the user who performed the action
Action	What action the user performed
Event ID	Unique identifier for the event
Category	Type of resource affected
Outcome	Whether the action succeeded or failed
Resource	Name and ID of the affected resource
Error	Why the action failed, for failed actions
Metadata	Additional context about the action

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.

Category	Description
Organization	Organization settings updates and deletion requests.
Member	Team member invitations, removals, role changes, and credential revocations.
Project	Project configuration changes including custom domains, authentication, Git sources, MCP client credentials, rollbacks, and build promotions.
Preview deployment	Preview deployment creation, updates, and authentication changes.
API key	API key and discovery API key creation and deletion.
Assistant	Assistant setting updates like deflection email, web search sites, and starter questions.
PDF export	PDF export generation and deletion.
Integration	Installations, removals, and configuration changes for integrations like GitHub, GitLab, Bitbucket, Azure DevOps, Slack, Discord, Microsoft Teams, Linear, Notion, and MCP connectors.
Billing	Subscription updates, add-on purchases, and invoice views.
Quota	Overage policy and alert configuration changes.
User	Individual user notification settings.
Audit log	Audit log views and exports.
Auth	Login attempts, logouts, session creations, and break-glass logins.

SSO, SCIM, and automation events don’t have their own category filter. To find them, select All categories. These include SSO connection and sign-in policy changes, break-glass and verified domain updates, SCIM provisioning and group role mapping changes, and automation changes and runs.

Stream audit logs

Audit log streaming is an add-on for Enterprise plans. Contact your account representative to enable it.

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 select 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. Next to Stream configuration, 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:

   Destination	Required details	Optional details
   Amazon S3	Bucket, AWS region, access key ID, and secret access key	Key prefix
   Datadog	Datadog site and API key	None

5. Click Add destination.

Prepare Amazon S3 credentials

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:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject"],
      "Resource": "arn:aws:s3:::your-bucket-name/audit-logs/*"
    }
  ]
}

Use the access key ID and secret access key from that IAM user when adding the destination. The key prefix is optional, and Mintlify prepends it to every object it writes.

Prepare Datadog credentials

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 you host your Datadog account, 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, open the actions menu for the destination, click Remove, then confirm.

Select streamed categories

1. Navigate to the Audit log page of your dashboard.
2. Next to Stream configuration, 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.

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.