> For the complete documentation index, see [llms.txt](https://docs.chirpwireless.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chirpwireless.io/reports/audit-trail.md).

# Activity Log

Every home needs a record of who has access and what changed. The Activity Log keeps a clear history of membership events in your Chirp home -- when someone was invited, when they joined, if their permissions were updated, or when they were removed. If you ever need to check who made a change or when a new member joined, this is where you look.

The Activity Log tracks membership activity only. It does not record device changes, automation edits, or dashboard updates.

## Finding the Activity Log

Open the sidebar and go to **Reports** > **Audit Trail**. The log shows events for the home you are currently viewing.

## What Gets Recorded

Four types of events appear in the log:

* **Invite sent** -- Someone in your home sent an invitation to a new member.
* **Invite accepted** -- A person accepted their invitation and joined the home.
* **Permissions changed** -- A member's access level was updated.
* **User removed** -- A member was removed from the home.

## Reading the Log

Events are displayed in a table with three columns:

| Column    | Description                                               |
| --------- | --------------------------------------------------------- |
| **Time**  | When the event happened, shown as HH:mm:ss.               |
| **Actor** | The email address of the person who performed the action. |
| **Event** | A plain-language summary of what occurred.                |

Entries are grouped by date. The table shows 50 events per page, with pagination controls at the bottom.

## Narrowing Down Events

Three filters sit above the table. Combine them freely to find exactly what you need.

* **Actor email** -- Start typing an email address and select from the autocomplete suggestions to see only actions by that person.
* **Event type** -- Open the multi-select dropdown and check one or more of the four event types. When nothing is selected, all types are shown.
* **Date range** -- Pick a start and end date using the calendar. Quick options like **Today** and **Yesterday** are available for fast filtering.

## Who Can See the Log

Any member whose permissions include access to the Audit Trail can view the log. The log is read-only for everyone -- entries cannot be edited or deleted.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chirpwireless.io/reports/audit-trail.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
