> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-8f43b31b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit logs

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

<Info>
  Audit logs are available on [Enterprise plans](https://mintlify.com/pricing?ref=audit-logs).
</Info>

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](https://app.mintlify.com/settings/organization/audit-logs) 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:

| 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                         |
| Category  | Type of resource affected                              |
| Outcome   | Whether the action succeeded or failed                 |
| 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.                                          |
| Deployment         | Deployment configuration changes including custom domains, authentication, Git sources, and MCP client credentials.   |
| 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        | GitHub and Slack installations and removals.                                                                          |
| Billing            | Subscription updates, add-on purchases, and invoice views.                                                            |
| Quota              | Overage policy and alert configuration changes.                                                                       |
| User               | Individual user notification settings.                                                                                |
| Automations        | Automation configurations and repository management.                                                                  |
| Audit log          | Audit log views and exports.                                                                                          |
| Auth               | Login attempts, logouts, session creations, and break-glass logins.                                                   |
| SSO                | SSO connection changes, sign-in policy updates, break-glass access updates, and verified domain changes.              |
| SCIM               | Automated user provisioning, updates, and deprovisioning from your identity provider, and group role mapping changes. |

## 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](https://app.mintlify.com/settings/organization/audit-logs) 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:

   | 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**.

To stop streaming to a destination, open the streaming configuration and click the <Icon icon="trash-2" /> remove icon next to the destination.

### Select streamed categories

1. Navigate to the [Audit log](https://app.mintlify.com/settings/organization/audit-logs) 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](https://app.mintlify.com/settings/organization/audit-logs) 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.