Skip to content

Audit log ​

Every pull, push, change, and team action is recorded in an append-only audit log. Rows are never updated or deleted.

Viewing the audit log ​

  • Per-project — open a project → Audit tab
  • Workspace-wide — Workspace → Audit

What's logged ​

ActionTrigger
var.createVariable created
var.updateVariable value or type changed
var.deleteVariable deleted
var.restoreVariable restored from history
vars.bulk_upsertBulk import or snapenv push
vars.bulk_deleteMulti-select delete
vars.pullCLI or operator pull
token.createAccess token created
token.revokeAccess token revoked
token.rotateAccess token rotated
member.inviteUser invited
member.removeMember removed
member.role_changeWorkspace role changed
access.grantUser added to project
access.updateProject role or env perms changed
access.revokeUser removed from project

Fields ​

Each log entry includes:

  • Action — what happened
  • Actor — user name (or token name for CLI actions)
  • Actor type — user (web/JWT) or token (CLI/access token)
  • Target key / env — which variable or environment was affected
  • Timestamp — UTC

API access ​

bash
# Project audit
GET /v1/projects/:id/audit?limit=50&cursor=

# Workspace audit
GET /v1/workspace/audit?limit=50

Supports cursor-based pagination via the nextCursor field in the response.

Built with SnapEnv