Audit Logs in Nila

Audit logs in Nila provide a complete record of important actions performed across your edition. Track member additions, invitations, role updates, and administrative activities to improve visibility, maintain accountability, and investigate changes when needed.

Access: Only Super Admins can view audit logs. If you don't see the Audit section under Settings, contact your edition owner to check your role and permissions.

What gets logged in Nila?

Each audit log entry captures the following details:

Field	Description
Event	The action that was performed
Performed by	The user who carried out the action
Affected entity	The user, team, or project that was impacted
Timestamp	The date and time the action occurred

Events that trigger audit logs

Only events with auditing enabled are recorded.

Below is a complete reference of all tracked events.

1. Edition & Invitation Events

Track invitation lifecycle activities within an edition.

Event	When it's recorded
Invite user to edition	An invitation is sent to a member
Reinvite user to edition	An existing invitation is resent
Accept invitation	An invited member accepts and joins the team or organization.

2. Team Events

Track the creation and deletion of teams within an edition.

Event	When it's recorded
Team add	A new team is created
Team delete	An existing team is removed

3. Team Member Events

Track membership and role changes within teams.

Event	When it's recorded
Team member add	A new member joins a team
Team member delete	A member is removed from a team
Team member update	A member's role within a team is changed
Team member restore	A previously removed member is re-added to a team

4. Project Member Events

Track access and role changes at the project level.

Event	When it's recorded
Project member add	A member is added to a project
Project member delete	A member is removed from a project
Project member update	A member's project role is changed
Project member restore	A previously removed member is re-added to a project

How to access audit logs

There are three ways to access audit log data, depending on whether you prefer a UI or programmatic access.

1. Via Settings (UI)

Open the Nila Web App.
Go to Settings → Audit from the left sidebar.
This view shows all edition-level activity, including member additions, role changes, and deletions, all in one place.

2. Via API: View Entries

Use the audit/get endpoint to fetch audit log entries programmatically. This is useful for integrating audit data into your own dashboards or internal tooling.

3. Via API: Export Entries

Use the audit/export endpoint to download the complete audit log as an auditlogs.json file. This is ideal for archiving, compliance reporting, or sharing logs with stakeholders outside Nila.

A note on permissions

Audit log access is restricted to Super Admins to protect member privacy and maintain data integrity. If you need access, contact your edition owner about updating your role.

Still have questions? Contact our support team at support@nila.design or reach out to your edition owner for help with roles and permissions.

Found this helpful?

Can't find what you need?

Try refining your search or explore our Help Center