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. A few agent actions are also recorded here; see 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.
- 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 are credited to the person who created the key. Changes made through the Risotto MCP server are credited to the person who authorized the client, and changes the Assistant makes are credited to the person who was using it.
Review a change
Open the Audit Log
In the dashboard, click Settings, then click Audit Log in the settings sidebar.
Open an entry's changes
Find the entry, then click its summary in the Changes column.
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.
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.
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. For example:
credentialfinds the Credential Vault events, and other events about credentials, such as Tool Connector Credentials Updated.runbookfinds runbook changes and runbook approvals.runbook_updatedfinds 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.
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.
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).Call the audit events endpoint
Send
GET https://api.tryrisotto.com/v1/audit-eventswith the key in anAuthorization: Bearer <key>header or anX-API-Keyheader.Poll for new events
To collect new events as they happen, request
created_after=<time of the last event you saved>&ordering=created. Thecreated_afterbound is inclusive, so the first event of each response can be one you already have: skip events by theirid.
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 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.
Something wrong or missing? Report an issue · View as Markdown