Hub documentation

Audit Logs

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Audit Logs

This feature is part of the Team & Enterprise plans.

Audit Logs enable organization admins to easily review actions taken by members, including organization membership, repository settings and billing changes.

screenshot of Hugging Face Audit Logs feature

Accessing Audit Logs

Audit Logs are accessible through your organization settings. Each log entry includes:

  • Who performed the action
  • What type of action was taken
  • A description of the change
  • Location and anonymized IP address
  • Date and time of the action

You can also download the complete audit log as a JSON file for further analysis.

What Events Are Tracked?

Each action has an event name in scope.action format (e.g. repo.create, collection.delete). This is the type field in each log entry and in the exported JSON—use it when searching or filtering logs.

Organization Management & Security

  • Core organization changes — Creation, deletion, restoration, renaming, and profile/settings updates.
    • Events: org.create, org.delete, org.restore, org.rename, org.update_settings
  • Security management
    • Organization API token rotation.
    • Event: org.rotate_token
    • Token approval system — Enabling or disabling the policy, authorization requests, approvals, denials, and revocations.
    • Events: org.token_approval.enabled, org.token_approval.disabled, org.token_approval.authorization_request, org.token_approval.authorization_request.authorized, org.token_approval.authorization_request.revoked, org.token_approval.authorization_request.denied
    • SSO — Logins and joins via SSO.
    • Events: org.sso_login, org.sso_join
  • Join settings — Domain-based access and automatic join configuration.
    • Event: org.update_join_settings

Membership and Access Control

  • Member lifecycle — Adding and removing members, role changes, and members leaving the organization.
    • Events: org.add_user, org.remove_user, org.change_role, org.leave
  • Invitations — Sending invites, invitation links by email, and users accepting invites.
    • Events: org.invite_user, org.invite.accept, org.invite.email
  • Automatic joins — Joins via verified email domain or “request access”.
    • Events: org.join.from_domain, org.join.automatic

Content and Resource Management

  • Repository administration — Creation, deletion, moving, disabling/re-enabling, duplication settings, DOI removal, resource group assignment, and general repo settings (visibility, gating, discussions, etc.). Also LFS file deletion.
    • Events: repo.create, repo.delete, repo.move, repo.disable, repo.removeDisable, repo.duplication, repo.delete_doi, repo.update_resource_group, repo.update_settings, repo.delete_lfs_file
  • Collections — Creation and deletion of collections.
    • Events: collection.create, collection.delete
  • Repository security — Secrets and variables (individual and bulk add/update/remove).
    • Events (secrets): repo.add_secret, repo.update_secret, repo.remove_secret, repo.add_secrets, repo.remove_secrets
    • Events (variables): repo.add_variable, repo.update_variable, repo.remove_variable, repo.add_variables, repo.remove_variables
  • Spaces configuration — Storage tier changes, hardware (flavor) updates, and sleep time adjustments.
    • Events: spaces.add_storage, spaces.remove_storage, spaces.update_hardware, spaces.update_sleep_time

Resource Groups

  • Resource group administration — Creation, deletion, and settings changes.
    • Events: resource_group.create, resource_group.delete, resource_group.settings
  • Resource group members — Adding and removing users, and role changes.
    • Events: resource_group.add_users, resource_group.remove_users, resource_group.change_role

Jobs and Scheduled Jobs

  • Jobs — Job creation (e.g. on a Space) and cancellation.
    • Events: jobs.create, jobs.cancel
  • Scheduled jobs — Creating, deleting, resuming, suspending, and triggering runs.
    • Events: scheduled_job.create, scheduled_job.delete, scheduled_job.resume, scheduled_job.suspend, scheduled_job.run

Billing and Cloud Integration

  • Payment and customers — Payment method updates, attachment, and removal; customer account creation.
    • Events: billing.update_payment_method, billing.create_customer, billing.remove_payment_method
  • Cloud marketplaces — AWS and GCP marketplace linking/unlinking and marketplace approval.
    • Events: billing.aws_add, billing.aws_remove, billing.gcp_add, billing.gcp_remove, billing.marketplace_approve
  • Subscriptions — Starting, renewing, cancelling, reactivating, and updating subscriptions (including plan and contract details).
    • Events: billing.start_subscription, billing.renew_subscription, billing.cancel_subscription, billing.un_cancel_subscription, billing.update_subscription, billing.update_subscription_plan, billing.update_subscription_contract_details

Event reference

The list above covers every event type shown in the audit log UI and export. Event names follow the scope.action pattern; scopes include org, repo, collection, spaces, resource_group, jobs, scheduled_job, and billing. The export action itself is recorded as org.audit_log.export but that event is not included in the default audit log view.

Update on GitHub