Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.squawkvoice.ai/llms.txt

Use this file to discover all available pages before exploring further.

Audit Logs give you a tamper-evident record of every action taken inside your SquawkVoice workspace — who changed what, when, and from where. Use them for compliance reviews, incident investigation, and change tracking.

What Gets Logged

Every create, update, and delete operation on platform resources is recorded automatically. Audit Logs also capture billing events. No configuration is required — logging is always on.

Resource Types

ResourceTracked Operations
AI AgentsCreated, updated, deleted
Actions (Pre, During, Post Call)Created, updated, deleted
VariablesCreated, updated, deleted
Knowledge BasesCreated, updated, deleted
Documents & FAQsCreated, updated, deleted
Web ScrapesCreated, updated, deleted
FlowsNode and edge updates
Data TransformersCreated, updated, deleted
Auth ProfilesCreated, updated, deleted
Connected AppsConnected, disconnected, deleted
Prompt TemplatesCreated, updated, deleted
UsersCreated, updated, deleted

Billing Events

EventDescription
SUBSCRIBED_TO_PLANWorkspace subscribed to a plan
UNSUBSCRIBED_FROM_PLANWorkspace cancelled or downgraded
PLAN_CHANGEDWorkspace moved to a different plan
CREDIT_LOADEDCredits manually added to the account
AUTO_TOPUP_ENABLEDAutomatic credit top-up turned on
AUTO_TOPUP_DISABLEDAutomatic credit top-up turned off
AUTO_TOPUP_MODIFIEDAuto top-up threshold or amount changed

Viewing Audit Logs

Open Studio → Manage → Audit Logs to view the full log table for your workspace. Logs are displayed in reverse chronological order. Each row shows:
ColumnDescription
ActorEmail or name of the user who performed the action
ActionThe operation type — CREATE, UPDATE, or DELETE, plus billing events
ResourceThe type and name of the affected resource
IP AddressClient IP at the time of the action
Date & TimeTimestamp of the event in your local timezone
Click any row to expand the full payload — the complete set of changes recorded for that event. Sensitive fields such as passwords, API keys, and tokens are automatically redacted from stored payloads.

Filtering

Use the filter bar at the top of the log table to narrow results:
FilterDescription
SearchFree-text search across actor, resource name, and other fields
ActorFilter by a specific user’s email or ID
ActionFilter by operation type (Create, Update, Delete, or billing events)
Resource TypeFilter by the type of resource affected (e.g. AI Agent, Action, Variable)
Date RangeFilter by a custom start and end date in your local timezone
Filters can be combined. The table updates in real time as you apply them.

Data Retention & Security

  • Audit log records are stored in Google Cloud BigQuery.
  • All sensitive fields in event payloads are automatically redacted before storage — passwords, API keys, tokens, and client secrets are never written to the log.
  • Logs are retained for the lifetime of the workspace and are not subject to the standard 60-day call data retention policy.
  • Access to Audit Logs is restricted to admin-level users within the workspace.
Enterprise customers can request audit log exports for external compliance reviews. Contact security@squawkvoice.ai for assistance.