> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit logs

> Track configuration changes and permission updates across your account

Audit logs track configuration, permission, and security changes made within your incident.io account, so you have a record of who changed what and when. Available on the [Enterprise plan](https://incident.io/pricing), powered by [WorkOS](https://workos.com/), with entries retained for one year.

<Note>
  You need the **View audit logs** permission, which Owners and Admins have by default. You can also grant it to a [custom role](/admin/user-permissions#custom-roles).
</Note>

## What’s tracked

Audit logs cover configuration, permission, and security events. They record:

* Alert sources, routes, priorities, and escalation paths
* Schedules, schedule overrides, and holiday feeds
* Custom fields, incident types, roles, statuses, timestamps, and severities
* Workflows, nudges, announcement rules, post-incident tasks, and post-mortem templates
* Status pages, policies, and Catalog types
* User creation, updates, deactivation, logins, and role assignments
* SCIM group role and seat mappings
* API key creation, rotation, and deletion
* Integration installs and uninstalls, IP allowlist changes, and secrets
* Access attempts, access requests, and membership changes on private incidents, alerts, and escalations
* Telemetry data source installs, access mode changes, and queries
* Insights measures, drilldowns, and exports that include private incident data
* Timeline items you delete, and incident, alert, or escalation data you scrub

Day-to-day incident work is recorded in each incident's activity log rather than here. Use the [incident activity log API](/api-reference/incident-activity-log-entries-v2) to pull that history into your own systems.

Each entry records the actor (person or system making the change), the target (what was modified), and contextual details like location and user agent. Entries follow a versioned schema, so older entries stay parseable. See the [audit log entry schema](/api-reference/audit-logs) for every entry type and its fields.

<img src="https://mintcdn.com/incidentio-18bb4170/aih-bzVNJc6xN5Zn/images/help-centre/audit-logs/screenshot-1.png?fit=max&auto=format&n=aih-bzVNJc6xN5Zn&q=85&s=96054254eb5e2414552487e020d8376d" alt="" width="1500" height="824" data-path="images/help-centre/audit-logs/screenshot-1.png" />

## Viewing audit logs

Access audit logs at [Settings → Security](https://app.incident.io/~/settings/security). From there you can:

* View entries in a web interface, filterable by target, event type, actor, and date
* Export entries for a given time period to CSV
* Set up a log stream to a SIEM provider (e.g. Datadog, Splunk, or an Amazon S3 bucket)

Entries reach you by log stream or CSV export rather than through the API.

<img src="https://mintcdn.com/incidentio-18bb4170/x_mvWkR2DHebgTRj/images/help-centre/audit-logs/screenshot-2.png?fit=max&auto=format&n=x_mvWkR2DHebgTRj&q=85&s=5791c098ed1035f73a45278fbeb83bd5" alt="" width="1400" height="870" data-path="images/help-centre/audit-logs/screenshot-2.png" />

## Retention

We keep entries for one year. Stream or export anything you need to keep for longer. Audit logs start on April 18, 2023.
