# Audit Log

See who changed your organization's configuration and when, open each change's previous and new values, and stream the log to a SIEM through the API

The Audit Log records changes to your organization's configuration: departments, runbooks, tools, credentials, access rules, integrations, settings, and more. Each entry names the event, who made the change, and when, and most entries keep the values before and after the change. Go to **Settings > Audit Log** to read it. Org Admins and Managers see this page.

The log covers configuration, not ticket conversations. Removing a comment from a ticket is not recorded here. What Risotto did on a ticket, such as the tools it ran and the approvals of each tool call, is on the ticket itself. See [Tool calls and approvals](https://www.tryrisotto.com/docs/dashboard/tickets/ticket-details#tool-calls-and-approvals). A few agent actions are also recorded here; see [Agent and Assistant actions](#agent-and-assistant-actions).

## What each entry shows

The newest entries come first. The table has four columns:

- **Date**: how long ago the event happened, such as "12 minutes ago". Hover over it to see the date and time.
- **Event**: what happened, such as **Access Rule Updated** or **Credential Rotated**. See [Recorded events](#recorded-events).
- **Changes**: the names of the fields that changed, such as "Max Hours Allowed, Renewal Requires Approval". When many fields changed, the summary ends with "+ N more changes". Click it to see the previous and new values.
- **User**: the name and email of the person who made the change. When the entry has an email but no name, it shows the email. When no person is recorded, for example for a change made by Directory Sync, it shows **System**.

The footer shows the total number of events, with **Rows per page** and buttons to move between pages.

On a narrow screen, each event is a card with its event name, user, date and time, and changes summary.

Changes made through an [API key](#stream-the-log-to-a-siem) are credited to the person who created the key. Changes made through the [Risotto MCP server](https://www.tryrisotto.com/docs/integrations/mcp-server) are credited to the person who authorized the client, and changes the [Assistant](https://www.tryrisotto.com/docs/dashboard/assistant) makes are credited to the person who was using it.

## Review a change

1. **Open the Audit Log**

   In the dashboard, click **Settings**, then click **Audit Log** in the
   settings sidebar.

2. **Open an entry's changes**

   Find the entry, then click its summary in the **Changes** column.

   *Product example: Settings, Audit Log in the Risotto dashboard: the newest events with their date, event, changes and user, and the Access Rule Updated entry's changes summary highlighted.*

3. **Read the previous and new values**

   A dialog named after the event lists each changed field with its
   **Previous** and **New** value. A field that was added shows **(empty)**
   as its previous value, and a field that was removed shows **(empty)** as
   its new value. For an entry that created something, every field is new;
   for an entry that deleted something, every field is previous.

   *Product example: The Access Rule Updated dialog in the Risotto audit log: Max Hours Allowed from 720 to 168, Renewal Requires Approval from false to true, and the rule's Modified time.*

An entry with nothing in **Changes** has no dialog in the dashboard. Through the API, `include_changes=true` returns the field-level changes of every event that recorded values before and after it.

Credential Vault entries record a credential's name, type, department, and allowed hosts, never its secret value. See [Credential Vault](https://www.tryrisotto.com/docs/dashboard/settings/credential-vault).

## Search the log

The search box above the table, **Filter by event or user**, matches the text you type anywhere in the event's key, without regard to case. The key is the event's internal name, listed in [Recorded events](#recorded-events). For example:

- `credential` finds the Credential Vault events, and other events about credentials, such as **Tool Connector Credentials Updated**.
- `runbook` finds runbook changes and runbook approvals.
- `runbook_updated` finds **Runbook Updated** only. Join words with an underscore, as in the key: "runbook updated", with a space, finds nothing.

The search does not match the user's name or email, and the page has no date filter. To find events in a date range, use the API's `created_after` and `created_before` parameters.

*Product example: The Risotto audit log searched for credential, showing only credential events: rotated, used by a program, created and updated.*

Click **View** to sort by **Date**, oldest or newest first, and to show or hide the **User**, **Date**, and **Changes** columns.

## Stream the log to a SIEM

The same events are available from the public API, so you can pull them into a SIEM or other log store. The dashboard has no export button.

1. **Create an API key with the audit scope**

   Go to **Settings > Developers > API keys** and create a key. Under
   **Audit**, select **Read Audit Log** (`audit:read`).

2. **Call the audit events endpoint**

   Send `GET https://api.tryrisotto.com/v1/audit-events` with the key in an
   `Authorization: Bearer <key>` header or an `X-API-Key` header.

3. **Poll for new events**

   To collect new events as they happen, request
   `created_after=<time of the last event you saved>&ordering=created`. The
   `created_after` bound is inclusive, so the first event of each response
   can be one you already have: skip events by their `id`.

The endpoint takes these query parameters:

| Parameter         | What it does                                                                              |
| ----------------- | ----------------------------------------------------------------------------------------- |
| `created_after`   | Only events created at or after this time (ISO 8601).                                     |
| `created_before`  | Only events created at or before this time (ISO 8601).                                    |
| `event`           | Only events with exactly this key, such as `org_runbook_updated`.                         |
| `ordering`        | `created` for oldest first, or `-created` for newest first. The default is `-created`.    |
| `include_changes` | `true` adds each event's field-level changes, with `field`, `old_value`, and `new_value`. |
| `limit`, `offset` | Page through the results. `limit` defaults to 50 and can be at most 100.                  |

Each event has an `id`, its `event` key, its `label` (the name the dashboard shows), `created`, an `actor` with `email`, `username`, `first_name`, and `last_name` (all `null` for a system event), and a `summary` of the changed fields. The response wraps the events in `results`, with the total in `count` and links to the `next` and `previous` pages. Requests are rate-limited per API key, and each response has `X-RateLimit-*` headers.

MCP clients connected to the [Risotto MCP server](https://www.tryrisotto.com/docs/integrations/mcp-server) with the `audit:read` scope can read the same log with the `list_audit_events` and `get_audit_event` tools. Only Org Admins and Managers can grant that scope.

## Agent and Assistant actions

The log is mostly people changing configuration, but some entries come from Risotto's agents:

- **Runbook approvals.** When a runbook's **Request Approval** step asks for approval, the log records **Runbook Approval Gate Requested**, and then **Approved**, **Denied**, **Expired**, or **Cancelled**. A decision is credited to the approver's email. Approvals of other tool calls are on the ticket, not here.
- **Slack channel visibility.** When the agent changes a Slack channel between public and private, the log records **Slack Channel Visibility Changed**, credited to the ticket's requestor.
- **Service catalog requests.** Filing a service catalog item for a ticket records **Org Service Catalog Item Requested**. Sending a requester to an item's page in the source portal records **Org Service Catalog Item Sent To Portal**.
- **Escalation routing.** When an escalation rule routes a ticket, the log records **Ticket.escalation Routed**, with no user.
- **The Assistant.** Changes the Assistant makes are recorded like any other change, credited to the person using it. The log also records when someone stops an Assistant run, when a program the Assistant wrote uses a vault credential, and when someone lifts a tool's approval requirement from an Assistant approval card.
- **Automations.** The log records approval decisions on automation runs, and **Automation Disabled After Too Many Runs** when Risotto turns off an automation that ran too often.

Other tool runs and the agent's replies are not in the Audit Log. They are on each ticket's timeline.

## Recorded events

Each table lists the name the **Event** column shows and the event's key, which you can type in the search box or pass to the API's `event` parameter. Names that look like a key in Title Case, such as **Org Form Created**, are shown exactly that way in the dashboard.

### Organization settings

| Shown as                                   | Event key                           |
| ------------------------------------------ | ----------------------------------- |
| **Organization Settings Created**          | `org_settings_created`              |
| **Organization Settings Updated**          | `org_settings_updated`              |
| **Org Action Settings Updated**            | `org_action_settings_updated`       |
| **Support Agent Context Settings Updated** | `support_agent_config_updated`      |
| **Org Support Email Address Updated**      | `org_support_email_address_updated` |
| **Org Ticket Custom Field Created**        | `org_ticket_custom_field_created`   |
| **Org Ticket Custom Field Updated**        | `org_ticket_custom_field_updated`   |
| **Org Ticket Custom Field Deleted**        | `org_ticket_custom_field_deleted`   |
| **Ticket View Visibility Updated**         | `ticket_view_visibility_updated`    |

### Departments and Directory Sync

| Shown as                                                      | Event key                            |
| ------------------------------------------------------------- | ------------------------------------ |
| **Department Created**                                        | `org_department_created`             |
| **Department Updated**                                        | `org_department_updated`             |
| **Department Deleted**                                        | `org_department_deleted`             |
| **Department Made Default**                                   | `org_department_made_default`        |
| **Department Member Added**                                   | `org_department_member_added`        |
| **Department Member Removed**                                 | `org_department_member_removed`      |
| **Department Member Role Updated**                            | `org_department_member_role_updated` |
| **T2a Dept Config Created**                                   | `t2a_dept_config_created`            |
| **T2a Dept Config Updated**                                   | `t2a_dept_config_updated`            |
| **Category Created**                                          | `org_dept_category_created`          |
| **Category Updated**                                          | `org_dept_category_updated`          |
| **Category Deleted**                                          | `org_dept_category_deleted`          |
| **Directory Sync Mapping Created**                            | `org_directory_dept_mapping_created` |
| **Directory Sync Mapping Updated**                            | `org_directory_dept_mapping_updated` |
| **Directory Sync Mapping Deleted**                            | `org_directory_dept_mapping_deleted` |
| **Department Member Added by Directory Sync**                 | `clerk_department_member_added`      |
| **Department Member Removed by Directory Sync**               | `clerk_department_member_removed`    |
| **Promoted Department Member Kept by Directory Sync**         | `clerk_department_member_kept`       |
| **Department Memberships Removed After Leaving Organization** | `clerk_member_departments_removed`   |
| **Organization Member Removed by Directory Sync**             | `clerk_membership_deleted`           |
| **User Deactivated by Directory Sync**                        | `clerk_user_deactivated`             |

### People and identities

| Shown as                               | Event key                              |
| -------------------------------------- | -------------------------------------- |
| **User Identity Removed From Profile** | `org_user_identity_detached`           |
| **Preferred Email Updated**            | `org_user_preferred_email_updated`     |
| **User Verification App Created**      | `org_user_verification_app_created`    |
| **User Verification App Updated**      | `org_user_verification_app_updated`    |
| **User Verification App Deleted**      | `org_user_verification_app_deleted`    |
| **Rippling Employee Sync Triggered**   | `rippling_provisioning_sync_triggered` |
| **Rippling Identity Provisioned**      | `rippling_identity_provisioned`        |
| **Rippling Identity Deactivated**      | `rippling_identity_deactivated`        |
| **Rippling Uninstalled**               | `rippling_uninstalled`                 |

### Applications, access, and approval policies

| Shown as                                                      | Event key                                   |
| ------------------------------------------------------------- | ------------------------------------------- |
| **Application Created**                                       | `org_app_created`                           |
| **Application Updated**                                       | `org_app_updated`                           |
| **Application Deleted**                                       | `org_app_deleted`                           |
| **Org Application Catalog Sync Quarantined**                  | `org_application_catalog_sync_quarantined`  |
| **Org Application Catalog Sync Reactivated**                  | `org_application_catalog_sync_reactivated`  |
| **Access Rule Created**                                       | `org_access_rule_created`                   |
| **Access Rule Updated**                                       | `org_access_rule_updated`                   |
| **Access Rule Deleted**                                       | `org_access_rule_deleted`                   |
| **Access Rule Duplicated**                                    | `org_access_rule_duplicated`                |
| **Access Rule Moved**                                         | `org_access_rule_moved`                     |
| **Org Access Rule Opal Access Level Updated**                 | `org_access_rule_opal_access_level_updated` |
| **Org Access Grant Expiration Canceled** (older entries only) | `org_access_grant_expiration_canceled`      |
| **Org Access Grant Expired Early** (older entries only)       | `org_access_grant_expired_early`            |
| **Note Created**                                              | `org_note_created`                          |
| **Note Deleted**                                              | `org_note_deleted`                          |
| **Org Approval Policy Created**                               | `org_approval_policy_created`               |
| **Org Approval Policy Updated**                               | `org_approval_policy_updated`               |
| **Org Approval Policy Deleted**                               | `org_approval_policy_deleted`               |
| **Org Opal Settings Created**                                 | `org_opal_settings_created`                 |
| **Org Opal Settings Updated**                                 | `org_opal_settings_updated`                 |
| **Opal Requestor Auto-Disabled**                              | `org_opal_requestor_identity_auto_disabled` |

Risotto no longer records early expiry or conversion to permanent here. Both leave an internal note on the ticket.

### Runbooks and forms

| Shown as                            | Event key                         |
| ----------------------------------- | --------------------------------- |
| **Runbook Created**                 | `org_runbook_created`             |
| **Runbook Updated**                 | `org_runbook_updated`             |
| **Runbook Deleted**                 | `org_runbook_deleted`             |
| **Runbook Duplicated**              | `org_runbook_duplicated`          |
| **Runbook Version Restored**        | `org_runbook_version_restored`    |
| **Org Runbook Draft Saved**         | `org_runbook_draft_saved`         |
| **Org Runbook Draft Approved**      | `org_runbook_draft_approved`      |
| **Org Runbook Draft Rejected**      | `org_runbook_draft_rejected`      |
| **Org Form Created**                | `org_form_created`                |
| **Org Form Updated**                | `org_form_updated`                |
| **Org Form Deleted**                | `org_form_deleted`                |
| **Runbook Approval Gate Requested** | `runbook_approval_gate_requested` |
| **Runbook Approval Gate Approved**  | `runbook_approval_gate_approved`  |
| **Runbook Approval Gate Denied**    | `runbook_approval_gate_denied`    |
| **Runbook Approval Gate Expired**   | `runbook_approval_gate_expired`   |
| **Runbook Approval Gate Cancelled** | `runbook_approval_gate_cancelled` |

### Tools, scripts, and connectors

| Shown as                                            | Event key                                         |
| --------------------------------------------------- | ------------------------------------------------- |
| **Tool Created**                                    | `org_tool_created`                                |
| **Tool Updated**                                    | `org_tool_updated`                                |
| **Tool Deleted**                                    | `org_tool_deleted`                                |
| **Org Tool Credentials Updated**                    | `org_tool_credentials_updated`                    |
| **Org Tool Approval Configured**                    | `org_tool_approval_configured`                    |
| **Org Tool Approval Requirement Changed**           | `org_tool_approval_requirement_changed`           |
| **Org Tool Standing Approval Lifted**               | `org_tool_standing_approval_lifted`               |
| **Org Tool Upgrade Started**                        | `org_tool_upgrade_started`                        |
| **Org Tool Upgrade Finalized**                      | `org_tool_upgrade_finalized`                      |
| **Script Draft Saved**                              | `org_script_draft_saved`                          |
| **Script Draft Editing Taken Over**                 | `org_script_draft_taken_over`                     |
| **Script Tool Published**                           | `org_script_published`                            |
| **Script Tool Disabled**                            | `org_script_disabled`                             |
| **Org Script Template Created**                     | `org_script_template_created`                     |
| **Org Script Template Published**                   | `org_script_template_published`                   |
| **Org Script Template Deleted**                     | `org_script_template_deleted`                     |
| **Tool Connector Connected**                        | `tool_connector_connected`                        |
| **Tool Connector Disconnected**                     | `tool_connector_disconnected`                     |
| **Tool Connector Credentials Created**              | `tool_connector_credentials_created`              |
| **Tool Connector Credentials Updated**              | `tool_connector_credentials_updated`              |
| **Tool Connector Credentials Deleted**              | `tool_connector_credentials_deleted`              |
| **Custom API Source Credentials Updated**           | `org_custom_api_source_credentials_updated`       |
| **Custom API Source Host Confirmed**                | `org_custom_api_source_host_confirmed`            |
| **Custom API Source Deleted**                       | `org_custom_api_source_deleted`                   |
| **External Mcp Tools Imported**                     | `external_mcp_tools_imported`                     |
| **External Mcp Server Bearer Reauthorized**         | `external_mcp_server_bearer_reauthorized`         |
| **External Mcp Server Custom Headers Reauthorized** | `external_mcp_server_custom_headers_reauthorized` |

### Credential Vault

| Shown as                           | Event key                          |
| ---------------------------------- | ---------------------------------- |
| **Credential Created**             | `org_credential_created`           |
| **Credential Updated**             | `org_credential_updated`           |
| **Credential Rotated**             | `org_credential_rotated`           |
| **Credential Deleted**             | `org_credential_deleted`           |
| **Credential Reference Created**   | `org_credential_reference_created` |
| **Credential Reference Deleted**   | `org_credential_reference_deleted` |
| **Org Credential Used By Program** | `org_credential_used_by_program`   |

### Automations

| Shown as                                      | Event key                                       |
| --------------------------------------------- | ----------------------------------------------- |
| **Automation Created**                        | `org_automation_created`                        |
| **Automation Updated**                        | `org_automation_updated`                        |
| **Automation Deleted**                        | `org_automation_deleted`                        |
| **Automation Duplicated**                     | `org_automation_duplicated`                     |
| **Automation Enabled**                        | `org_automation_enabled`                        |
| **Automation Disabled**                       | `org_automation_disabled`                       |
| **Automation Disabled After Too Many Runs**   | `org_automation_rate_limited`                   |
| **Automation Run Approvals Decided**          | `org_automation_run_approvals_decided`          |
| **Automation Webhook Auth Token Generated**   | `org_automation_webhook_auth_token_generated`   |
| **Automation Webhook Auth Token Regenerated** | `org_automation_webhook_auth_token_regenerated` |
| **Automation Webhook Auth Token Revealed**    | `org_automation_webhook_auth_token_revealed`    |

### Campaigns and service catalog

| Shown as                                              | Event key                                           |
| ----------------------------------------------------- | --------------------------------------------------- |
| **Campaign Created**                                  | `org_campaign_created`                              |
| **Campaign Updated**                                  | `org_campaign_updated`                              |
| **Campaign Duplicated**                               | `org_campaign_duplicated`                           |
| **Campaign Reminder Sent**                            | `org_campaign_nudged`                               |
| **Org Campaign Unscheduled**                          | `org_campaign_unscheduled`                          |
| **Campaign Canceled**                                 | `org_campaign_canceled`                             |
| **Campaign Deleted**                                  | `org_campaign_deleted`                              |
| **Org Service Catalog Item Imported**                 | `org_service_catalog_item_imported`                 |
| **Org Service Catalog Item Updated**                  | `org_service_catalog_item_updated`                  |
| **Org Service Catalog Item Deleted**                  | `org_service_catalog_item_deleted`                  |
| **Org Service Catalog Item Requested**                | `org_service_catalog_item_requested`                |
| **Org Service Catalog Item Sent To Portal**           | `org_service_catalog_item_sent_to_portal`           |
| **Org Service Catalog Item Upgraded To Risotto Form** | `org_service_catalog_item_upgraded_to_risotto_form` |

### Knowledge

| Shown as                                              | Event key                                           |
| ----------------------------------------------------- | --------------------------------------------------- |
| **Knowledge Article Updated**                         | `kb_article_updated`                                |
| **Knowledge Article Deleted**                         | `kb_article_deleted`                                |
| **Knowledge Article Exported**                        | `kb_article_exported`                               |
| **Index Updated**                                     | `org_index_updated`                                 |
| **Index Reindexed**                                   | `org_index_reindexed`                               |
| **Index Search Enabled**                              | `org_index_search_enabled`                          |
| **Index Search Disabled**                             | `org_index_search_disabled`                         |
| **Index Deleted**                                     | `index_deleted`                                     |
| **Org Index Deleted With Runbook Directives**         | `org_index_deleted_with_runbook_directives`         |
| **Notion Webhook Confirmed**                          | `notion_webhook_confirmed`                          |
| **Notion Webhook Deleted**                            | `notion_webhook_deleted`                            |
| **Org Confluence Disconnected**                       | `org_confluence_disconnected`                       |
| **Org Slack Real Time Search Created**                | `org_slack_real_time_search_created`                |
| **Org Slack Real Time Search Channel Filter Updated** | `org_slack_real_time_search_channel_filter_updated` |
| **Org Slack Real Time Search Deleted**                | `org_slack_real_time_search_deleted`                |

### Slack, Microsoft Teams, and request sources

| Shown as                                     | Event key                              |
| -------------------------------------------- | -------------------------------------- |
| **Slack App Created**                        | `org_slack_app_created`                |
| **Slack App Updated**                        | `org_slack_app_updated`                |
| **Slack App Deleted**                        | `org_slack_app_deleted`                |
| **Slack Tools App Created**                  | `org_slack_tools_app_created`          |
| **Slack Tools App Updated**                  | `org_slack_tools_app_updated`          |
| **Slack Tools App Deleted**                  | `org_slack_tools_app_deleted`          |
| **Slack Tools Events Url Verified**          | `slack_tools_events_url_verified`      |
| **Channel Settings Updated**                 | `org_channel_settings_updated`         |
| **Org Slack Ticket List Enabled**            | `org_slack_ticket_list_enabled`        |
| **Org Slack Ticket List Disabled**           | `org_slack_ticket_list_disabled`       |
| **Org Msteams Channel Settings Created**     | `org_msteams_channel_settings_created` |
| **Microsoft Teams Channel Settings Updated** | `org_msteams_channel_settings_updated` |

### Integrations, OAuth, and webhooks

| Shown as                                | Event key                             |
| --------------------------------------- | ------------------------------------- |
| **Okta Connection Updated**             | `org_okta_connection_updated`         |
| **Org Okta Event Subscription Updated** | `org_okta_event_subscription_updated` |
| **GitHub Connected**                    | `org_github_connected`                |
| **Jira Connected**                      | `org_jira_connected`                  |
| **Jira Disconnected**                   | `org_jira_disconnected`               |
| **Jira Uninstalled**                    | `jira_uninstalled`                    |
| **Jira Connect App Uninstalled**        | `jira_connect_uninstalled`            |
| **Forge Integration Disconnected**      | `forge_integration_disconnected`      |
| **Forge Migration Verification Failed** | `forge_migration_verification_failed` |
| **Org Oauth Client Connected**          | `org_oauth_client_connected`          |
| **OAuth Client Revoked**                | `org_oauth_client_revoked`            |
| **OAuth Token Deleted**                 | `org_oauth_token_deleted`             |
| **Webhook Endpoint Created**            | `webhook_endpoint_created`            |
| **Webhook Endpoint Updated**            | `webhook_endpoint_updated`            |
| **Webhook Endpoint Deleted**            | `webhook_endpoint_deleted`            |
| **Webhook Endpoint Auto-Disabled**      | `webhook_endpoint_auto_disabled`      |

### Assistant, artifacts, and tickets

| Shown as                                  | Event key                               |
| ----------------------------------------- | --------------------------------------- |
| **Assistant Run Cancelled**               | `assistant_run_cancelled`               |
| **Assistant Conversation Shares Updated** | `assistant_conversation_shares_updated` |
| **Org Artifact Created**                  | `org_artifact_created`                  |
| **Org Artifact Updated**                  | `org_artifact_updated`                  |
| **Org Artifact Deleted**                  | `org_artifact_deleted`                  |
| **Slack Channel Visibility Changed**      | `slack_channel_visibility_changed`      |
| **Ticket.escalation Routed**              | `ticket.escalation_routed`              |

## Permissions

Only **Org Admins** and **Managers** see **Audit Log** in the settings sidebar and can open the page. Through the API and the MCP server, reading the log needs the `audit:read` scope. See [Permissions](https://www.tryrisotto.com/docs/operating/permissions#organization-roles).

Source: https://www.tryrisotto.com/docs/dashboard/settings/audit-log
