Skip to content

docs(dashboard): add Admin Logs page#3480

Closed
Jibaru wants to merge 5 commits into
mainfrom
irueda/admin-logs-doc
Closed

docs(dashboard): add Admin Logs page#3480
Jibaru wants to merge 5 commits into
mainfrom
irueda/admin-logs-doc

Conversation

@Jibaru

@Jibaru Jibaru commented Jun 26, 2026

Copy link
Copy Markdown
Member

What does this solve? What changed?

New /docs/guides/dashboard/logs/admin-logs.
Mirrors the application-logs.mdx structure (intro, filters, detail view, plan/retention table).

Other resources

https://linear.app/clerk/issue/USER-5585/update-docs-with-the-list-of-admin-log-events

New /docs/guides/dashboard/logs/admin-logs sibling to the existing
Application Logs page. Frames Admin Logs as the audit trail for
workspace admin actions (C1 actors via Dashboard / BAPI) — distinct
from Application Logs, which track end-user activity.

Mirrors the application-logs.mdx structure (intro, filters, detail
view, plan/retention table) and lists every (admin_log)-tagged event
type currently defined in the Clerk event_stream proto, grouped into
22 sections that match the in-product Notion catalog.

Manifest updated to surface the page under Dashboard > Logs.
@vercel

vercel Bot commented Jun 26, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clerk-docs Ready Ready Preview Jul 16, 2026 3:13pm

Request Review

The dashboard-driven create owns the canonical
oauth_application.created type. The DCR (RFC 7591) flow moves to
oauth_application.dynamically_registered on the Application Logs page.

- Application Logs: oauth_application.created → oauth_application.dynamically_registered
- Admin Logs: oauth_application.created_by_admin → oauth_application.created
Replaces the hand-authored "Supported events" section in the Admin Logs
guide with output from the new gen-admin-log-docs tool in clerk_go, which
walks the compiled proto registry and emits markdown tables grouped by
each admin_log's `docs_group` and rendered from its `docs_description`
(passive-voice, actor-less phrasing).

Also reverts the `oauth_application.created` → `oauth_application.dynamically_registered`
rename in application-logs.mdx that landed in 6702755, restoring the
event type shipping in production.

Companion clerk_go PR: clerk/clerk_go#20369.
@github-actions

Copy link
Copy Markdown
Contributor

⚠️ This PR cannot be merged here. The Clerk docs now live in clerk/clerk under clerk-docs/. Please migrate this PR by running:

pnpm migrate:clerk

Run it locally from the root of this branch and it'll migrate the branch and PR over to clerk/clerk and close this PR automatically. If new commits land on this PR after migration, re-running the same command is safe: it updates the existing clerk/clerk branch and PR instead of creating a new one.

The required Block merges (migration to clerk/clerk required) check on this PR will keep failing on purpose until the PR is migrated and closed.

Regenerated from clerk_go — "An organization was left" is now
"A member was removed from an organization", mirroring the sibling
`organization_membership.created` row.
@Jibaru

Jibaru commented Jul 16, 2026

Copy link
Copy Markdown
Member Author

This branch and PR were migrated to clerk/clerk. Migration branches/PRs created from this PR (most recent last):

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.

2 participants