Skip to content

Audit log and analytics

Every login, failed attempt, change to a user and change of settings is written to the environment’s audit trail, with who did it, from where and when. Events about a user can also go to your webhooks; the admin.* events never do.

GET/v1/environments/:id/auditviewer
Query Meaning
event An event name or the start of one: user. gives every user event, admin. every change of settings.
user_id The events a user did, and those done to them.
before An occurred_at: the page after it.
limit 50 by default, at most 200.

event is matched as a prefix, and %, _ and \ are removed from it first. A name with an underscore, such as app_user.joined or admin.client.secret_rotated, therefore matches nothing as written: ask for the part before the underscore (app or admin.client.secret) instead.

{
"events": [
{
"id": "…",
"occurred_at": "…",
"event": "login.succeeded",
"actor_user_id": "…",
"subject_user_id": "…",
"ip": "…",
"user_agent": "…",
"data": { "method": "email_code" }
}
],
"next_before": null,
"retention_days": null
}
Field Meaning
actor_user_id Who did it: the user themselves, or null when it was done from the dashboard or with an API key.
subject_user_id Whom it was done to.
data What the event says. A change of settings carries the developer’s id, and api_key_id when an API key made it.
retention_days How many days the workspace’s plan keeps: 30 on Free, null on paid plans, which keep a year.
Event When
user.created, user.updated, user.deleted An account was made, changed (name, picture, email address) or deleted.
user.disabled, user.enabled A user was disabled or enabled again.
app_user.joined A user entered an app for the first time.
login.succeeded, login.failed A login completed, or an attempt was refused.
session.started, session.raised A session ticket gave a browser a session of its own (session.raised: raised the one it had, before 2026-11-17).
session.revoked A session ended: a logout, or it was ended from the dashboard, the API or the account settings.
mfa.enrolled, mfa.removed, mfa.failed A second factor was added (or new recovery codes made), removed, or failed.
identity.linked, identity.unlinked A way to log in was connected or removed.
password.changed, password.reset, password.removed A password was set or changed, reset during a login, or removed.
email.changed A new email address.
role.assigned, role.removed A user was given a role, or lost one.
refresh.reuse_detected, code.reuse_detected A refresh token or an authorization code was presented a second time, and the tokens that came from it were revoked.
key.rotated The environment’s signing keys rotated.
admin.* A change of settings, such as admin.client.created, admin.policy.updated, admin.login_methods.updated, admin.webhook.secret_rolled or admin.issuer.changed. Changes to workspaces, members, API keys and billing are not part of an environment’s audit log.

The Analytics page counts from what is already in the audit trail and the usage counts; nothing else is collected for it.

GET/v1/environments/:id/analytics?range=7dviewer

range is 24h, 7d (default), 30d or 90d. The last two need a plan with analytics (Pro and Scale); without it they answer 402 plan_limit. Answers are kept for five minutes.

{
"range": "7d",
"bucket": "day",
"from": "…",
"to": "…",
"users": 42,
"mau": 17,
"totals": { "logins": 3, "failed": 1, "signups": 2, "active_users": 2 },
"previous": { "logins": 1, "failed": 0, "signups": 1, "active_users": 1 },
"series": [{ "t": "…", "logins": 1, "failed": 0, "signups": 1, "active": 1 }],
"splits": {
"methods": [{ "key": "email_code", "count": 3 }],
"countries": [{ "key": "DE", "count": 3 }],
"devices": [],
"browsers": [],
"systems": [],
"apps": [{ "key": "…", "name": "Your App", "count": 3 }]
},
"advanced": true,
"retention_days": null,
"ranges": [
{ "id": "24h", "locked": false },
{ "id": "7d", "locked": false },
{ "id": "30d", "locked": false },
{ "id": "90d", "locked": false }
]
}
Field Meaning
bucket hour or day: one point of series each, with gaps filled.
totals, previous The counts of this period and of the one before it.
splits Logins by method, country, device, browser, system and app: up to 8 named slices each, and "" for the rest. null without a plan with analytics.
ranges Which ranges the plan allows (locked: true for the others).
Status code When
400 bad_request “range is 24h, 7d, 30d or 90d”
402 plan_limit 30d or 90d without analytics in the plan.
GET/v1/environments/:id/analytics/liveviewer

The last five minutes in five-second steps, and who is here now, with nobody named. Needs a plan with analytics (402 otherwise).

{
"now": "…",
"step_seconds": 5,
"active_now": 2,
"points": [{ "t": "…", "logins": 0, "failed": 0, "signups": 0 }],
"recent": [
{ "at": "…", "event": "login.succeeded", "app": "Your App", "method": "email_code", "country": "DE", "device": "mobile", "browser": "Safari", "system": "iOS" }
]
}

active_now counts the sessions used in the last six minutes (an app in use renews its token every five minutes with the default lifetimes). points has 60 entries and recent up to 12.