Docs

Admin / Security

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

  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.

  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.

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:

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

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:

ParameterWhat it does
created_afterOnly events created at or after this time (ISO 8601).
created_beforeOnly events created at or before this time (ISO 8601).
eventOnly events with exactly this key, such as org_runbook_updated.
orderingcreated for oldest first, or -created for newest first. The default is -created.
include_changestrue adds each event's field-level changes, with field, old_value, and new_value.
limit, offsetPage 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 asEvent key
Organization Settings Createdorg_settings_created
Organization Settings Updatedorg_settings_updated
Org Action Settings Updatedorg_action_settings_updated
Support Agent Context Settings Updatedsupport_agent_config_updated
Org Support Email Address Updatedorg_support_email_address_updated
Org Ticket Custom Field Createdorg_ticket_custom_field_created
Org Ticket Custom Field Updatedorg_ticket_custom_field_updated
Org Ticket Custom Field Deletedorg_ticket_custom_field_deleted
Ticket View Visibility Updatedticket_view_visibility_updated

Departments and Directory Sync

Shown asEvent key
Department Createdorg_department_created
Department Updatedorg_department_updated
Department Deletedorg_department_deleted
Department Made Defaultorg_department_made_default
Department Member Addedorg_department_member_added
Department Member Removedorg_department_member_removed
Department Member Role Updatedorg_department_member_role_updated
T2a Dept Config Createdt2a_dept_config_created
T2a Dept Config Updatedt2a_dept_config_updated
Category Createdorg_dept_category_created
Category Updatedorg_dept_category_updated
Category Deletedorg_dept_category_deleted
Directory Sync Mapping Createdorg_directory_dept_mapping_created
Directory Sync Mapping Updatedorg_directory_dept_mapping_updated
Directory Sync Mapping Deletedorg_directory_dept_mapping_deleted
Department Member Added by Directory Syncclerk_department_member_added
Department Member Removed by Directory Syncclerk_department_member_removed
Promoted Department Member Kept by Directory Syncclerk_department_member_kept
Department Memberships Removed After Leaving Organizationclerk_member_departments_removed
Organization Member Removed by Directory Syncclerk_membership_deleted
User Deactivated by Directory Syncclerk_user_deactivated

People and identities

Shown asEvent key
User Identity Removed From Profileorg_user_identity_detached
Preferred Email Updatedorg_user_preferred_email_updated
User Verification App Createdorg_user_verification_app_created
User Verification App Updatedorg_user_verification_app_updated
User Verification App Deletedorg_user_verification_app_deleted
Rippling Employee Sync Triggeredrippling_provisioning_sync_triggered
Rippling Identity Provisionedrippling_identity_provisioned
Rippling Identity Deactivatedrippling_identity_deactivated
Rippling Uninstalledrippling_uninstalled

Applications, access, and approval policies

Shown asEvent key
Application Createdorg_app_created
Application Updatedorg_app_updated
Application Deletedorg_app_deleted
Org Application Catalog Sync Quarantinedorg_application_catalog_sync_quarantined
Org Application Catalog Sync Reactivatedorg_application_catalog_sync_reactivated
Access Rule Createdorg_access_rule_created
Access Rule Updatedorg_access_rule_updated
Access Rule Deletedorg_access_rule_deleted
Access Rule Duplicatedorg_access_rule_duplicated
Access Rule Movedorg_access_rule_moved
Org Access Rule Opal Access Level Updatedorg_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 Createdorg_note_created
Note Deletedorg_note_deleted
Org Approval Policy Createdorg_approval_policy_created
Org Approval Policy Updatedorg_approval_policy_updated
Org Approval Policy Deletedorg_approval_policy_deleted
Org Opal Settings Createdorg_opal_settings_created
Org Opal Settings Updatedorg_opal_settings_updated
Opal Requestor Auto-Disabledorg_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 asEvent key
Runbook Createdorg_runbook_created
Runbook Updatedorg_runbook_updated
Runbook Deletedorg_runbook_deleted
Runbook Duplicatedorg_runbook_duplicated
Runbook Version Restoredorg_runbook_version_restored
Org Runbook Draft Savedorg_runbook_draft_saved
Org Runbook Draft Approvedorg_runbook_draft_approved
Org Runbook Draft Rejectedorg_runbook_draft_rejected
Org Form Createdorg_form_created
Org Form Updatedorg_form_updated
Org Form Deletedorg_form_deleted
Runbook Approval Gate Requestedrunbook_approval_gate_requested
Runbook Approval Gate Approvedrunbook_approval_gate_approved
Runbook Approval Gate Deniedrunbook_approval_gate_denied
Runbook Approval Gate Expiredrunbook_approval_gate_expired
Runbook Approval Gate Cancelledrunbook_approval_gate_cancelled

Tools, scripts, and connectors

Shown asEvent key
Tool Createdorg_tool_created
Tool Updatedorg_tool_updated
Tool Deletedorg_tool_deleted
Org Tool Credentials Updatedorg_tool_credentials_updated
Org Tool Approval Configuredorg_tool_approval_configured
Org Tool Approval Requirement Changedorg_tool_approval_requirement_changed
Org Tool Standing Approval Liftedorg_tool_standing_approval_lifted
Org Tool Upgrade Startedorg_tool_upgrade_started
Org Tool Upgrade Finalizedorg_tool_upgrade_finalized
Script Draft Savedorg_script_draft_saved
Script Draft Editing Taken Overorg_script_draft_taken_over
Script Tool Publishedorg_script_published
Script Tool Disabledorg_script_disabled
Org Script Template Createdorg_script_template_created
Org Script Template Publishedorg_script_template_published
Org Script Template Deletedorg_script_template_deleted
Tool Connector Connectedtool_connector_connected
Tool Connector Disconnectedtool_connector_disconnected
Tool Connector Credentials Createdtool_connector_credentials_created
Tool Connector Credentials Updatedtool_connector_credentials_updated
Tool Connector Credentials Deletedtool_connector_credentials_deleted
Custom API Source Credentials Updatedorg_custom_api_source_credentials_updated
Custom API Source Host Confirmedorg_custom_api_source_host_confirmed
Custom API Source Deletedorg_custom_api_source_deleted
External Mcp Tools Importedexternal_mcp_tools_imported
External Mcp Server Bearer Reauthorizedexternal_mcp_server_bearer_reauthorized
External Mcp Server Custom Headers Reauthorizedexternal_mcp_server_custom_headers_reauthorized

Credential Vault

Shown asEvent key
Credential Createdorg_credential_created
Credential Updatedorg_credential_updated
Credential Rotatedorg_credential_rotated
Credential Deletedorg_credential_deleted
Credential Reference Createdorg_credential_reference_created
Credential Reference Deletedorg_credential_reference_deleted
Org Credential Used By Programorg_credential_used_by_program

Automations

Shown asEvent key
Automation Createdorg_automation_created
Automation Updatedorg_automation_updated
Automation Deletedorg_automation_deleted
Automation Duplicatedorg_automation_duplicated
Automation Enabledorg_automation_enabled
Automation Disabledorg_automation_disabled
Automation Disabled After Too Many Runsorg_automation_rate_limited
Automation Run Approvals Decidedorg_automation_run_approvals_decided
Automation Webhook Auth Token Generatedorg_automation_webhook_auth_token_generated
Automation Webhook Auth Token Regeneratedorg_automation_webhook_auth_token_regenerated
Automation Webhook Auth Token Revealedorg_automation_webhook_auth_token_revealed

Campaigns and service catalog

Shown asEvent key
Campaign Createdorg_campaign_created
Campaign Updatedorg_campaign_updated
Campaign Duplicatedorg_campaign_duplicated
Campaign Reminder Sentorg_campaign_nudged
Org Campaign Unscheduledorg_campaign_unscheduled
Campaign Canceledorg_campaign_canceled
Campaign Deletedorg_campaign_deleted
Org Service Catalog Item Importedorg_service_catalog_item_imported
Org Service Catalog Item Updatedorg_service_catalog_item_updated
Org Service Catalog Item Deletedorg_service_catalog_item_deleted
Org Service Catalog Item Requestedorg_service_catalog_item_requested
Org Service Catalog Item Sent To Portalorg_service_catalog_item_sent_to_portal
Org Service Catalog Item Upgraded To Risotto Formorg_service_catalog_item_upgraded_to_risotto_form

Knowledge

Shown asEvent key
Knowledge Article Updatedkb_article_updated
Knowledge Article Deletedkb_article_deleted
Knowledge Article Exportedkb_article_exported
Index Updatedorg_index_updated
Index Reindexedorg_index_reindexed
Index Search Enabledorg_index_search_enabled
Index Search Disabledorg_index_search_disabled
Index Deletedindex_deleted
Org Index Deleted With Runbook Directivesorg_index_deleted_with_runbook_directives
Notion Webhook Confirmednotion_webhook_confirmed
Notion Webhook Deletednotion_webhook_deleted
Org Confluence Disconnectedorg_confluence_disconnected
Org Slack Real Time Search Createdorg_slack_real_time_search_created
Org Slack Real Time Search Channel Filter Updatedorg_slack_real_time_search_channel_filter_updated
Org Slack Real Time Search Deletedorg_slack_real_time_search_deleted

Slack, Microsoft Teams, and request sources

Shown asEvent key
Slack App Createdorg_slack_app_created
Slack App Updatedorg_slack_app_updated
Slack App Deletedorg_slack_app_deleted
Slack Tools App Createdorg_slack_tools_app_created
Slack Tools App Updatedorg_slack_tools_app_updated
Slack Tools App Deletedorg_slack_tools_app_deleted
Slack Tools Events Url Verifiedslack_tools_events_url_verified
Channel Settings Updatedorg_channel_settings_updated
Org Slack Ticket List Enabledorg_slack_ticket_list_enabled
Org Slack Ticket List Disabledorg_slack_ticket_list_disabled
Org Msteams Channel Settings Createdorg_msteams_channel_settings_created
Microsoft Teams Channel Settings Updatedorg_msteams_channel_settings_updated

Integrations, OAuth, and webhooks

Shown asEvent key
Okta Connection Updatedorg_okta_connection_updated
Org Okta Event Subscription Updatedorg_okta_event_subscription_updated
GitHub Connectedorg_github_connected
Jira Connectedorg_jira_connected
Jira Disconnectedorg_jira_disconnected
Jira Uninstalledjira_uninstalled
Jira Connect App Uninstalledjira_connect_uninstalled
Forge Integration Disconnectedforge_integration_disconnected
Forge Migration Verification Failedforge_migration_verification_failed
Org Oauth Client Connectedorg_oauth_client_connected
OAuth Client Revokedorg_oauth_client_revoked
OAuth Token Deletedorg_oauth_token_deleted
Webhook Endpoint Createdwebhook_endpoint_created
Webhook Endpoint Updatedwebhook_endpoint_updated
Webhook Endpoint Deletedwebhook_endpoint_deleted
Webhook Endpoint Auto-Disabledwebhook_endpoint_auto_disabled

Assistant, artifacts, and tickets

Shown asEvent key
Assistant Run Cancelledassistant_run_cancelled
Assistant Conversation Shares Updatedassistant_conversation_shares_updated
Org Artifact Createdorg_artifact_created
Org Artifact Updatedorg_artifact_updated
Org Artifact Deletedorg_artifact_deleted
Slack Channel Visibility Changedslack_channel_visibility_changed
Ticket.escalation Routedticket.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