Skip to content

docs: add audit log documentation for enterprise#1308

Open
factory-austin wants to merge 3 commits into
mainfrom
docs/audit-log
Open

docs: add audit log documentation for enterprise#1308
factory-austin wants to merge 3 commits into
mainfrom
docs/audit-log

Conversation

@factory-austin

@factory-austin factory-austin commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a new enterprise documentation page for the Factory audit log feature, based on the internal Notion spec here
https://app.notion.com/p/factory-ai/Docs-for-AuditLog-39f2517972c7809fa551cb59552ae712?source=copy_link

What's included

  • New page: docs/enterprise/audit-log.mdx
  • Navigation: Added to the Analytics & Compliance group in docs.json, after "Compliance, Audit & Monitoring"

Content

The page documents:

  • Event structure — shared fields across all audit events (eventType, actor, source, target, payload, createdAt) and the actor sub-object
  • Event sources — all source values (web settings pages, public API, WorkOS events)
  • Event types — 9 event types with their target fields, payload fields, intent values, and JSON examples:
    • user_limit_change
    • membership_change
    • api_key_lifecycle_change
    • service_account_change
    • integration_change
    • organization_lifecycle_change
    • managed_settings_change
    • analytics_settings_change
    • voucher_redeemed

Notes

  • The audit log is an Enterprise feature, restricted to organization owners.
  • No JP translation included (consistent with other recently added enterprise pages that lack JP equivalents).

Add a new enterprise docs page documenting the Factory audit log feature,
including event structure, event sources, and all event types with
examples. Sourced from the internal Notion spec.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@factory-droid

factory-droid Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Droid is reviewing code and running a security check…

View job run

@mintlify

mintlify Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
factory 🟢 Ready View Preview Jul 16, 2026, 10:31 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@mintlify

mintlify Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
factory 🟡 Building Jul 16, 2026, 10:30 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant