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

# Audit events

Use **Audit** in the dashboard sidebar to review recent authorization, access, and security-sensitive events for the selected organization. It is an investigation view, not a complete record of every content change or background job.

Access to the page follows the `list org:token` capability. Do not assume a role title alone guarantees visibility. If Audit is unavailable, confirm the selected organization and ask someone with the appropriate authority to review your access; see [Members and roles](https://docs.katara.ai/about/organization-administration/members.md).

## Find an event

1. Select the organization where the action occurred and open **Audit**.
2. Narrow the list using **Event type**, **Resource type**, or **Actor id**. The event-type field gives `authz.check` as an example; the resource-type field gives `document`.
3. Choose an outcome: **All outcomes**, **Allowed**, **Denied**, **Succeeded**, **Failed**, or **Error**.
4. Review the matching rows and use **Load More** when available.
5. If no matches appear, clear or broaden the filters before concluding that no relevant event exists.

The text filters update after typing. A loaded page is not an exhaustive export, and a filtered empty result does not establish that an operation never happened.

## Read the columns

* **Timestamp** shows when the event was recorded.
* **Actor** identifies the acting identity or authorization subject. A delegated action can also display the user it acted on behalf of. A missing identity label may appear as **System**; this is a display fallback, not evidence of a specific human actor.
* **Event Type** names the recorded event.
* **Resource** combines the resource type and its identifier when present.
* **Outcome** distinguishes an authorization decision from an operation result. **Allowed** does not necessarily mean the downstream work succeeded.
* **Details** shows the request procedure and, where available, an authorization relation or access path. It is not a full request-body viewer.

Hover over truncated actor, resource, or details text to inspect its full label.

## Limits and follow-up

The current page provides filters, a table, and pagination. It does not establish a retention guarantee, downloadable audit export, tamper-proof compliance archive, or replay/rollback workflow. Do not use missing rows as proof that access remains valid or that no data was disclosed.

For Brain refresh, Wiki revisions, or export outcomes, inspect the Brain’s **Activity** views instead; see [Brains](https://docs.katara.ai/about/brains/overview.md). Investigate sharing and credentials through [Access and API grants](https://docs.katara.ai/about/organization-administration/access.md).

When escalating an issue, preserve the event type, timestamp, actor/resource identifiers, outcome, and displayed details. Include the affected organization and expected action, but never include JWTs, repository tokens, or other secrets.
