> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roserx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit Log

> Track every action taken across the RoseRx Platform with a comprehensive, searchable audit trail.

The Audit Log provides a comprehensive trail of every significant action performed across the RoseRx Platform. It supports your governance and compliance requirements by recording who did what, when, and whether the action succeeded — giving you full accountability across your organization.

<Info>
  The Audit Log captures actions automatically. No configuration is required — every tracked action is logged from the moment your organization is created.
</Info>

## Accessing the audit log

Navigate to **Monitor → Audit Log** in the left sidebar.

## Filtering events

Use the filter bar to narrow the log to the events you're interested in:

* **Actor** — Filter by the person or system that performed the action.
* **Action** — Filter by the type of action (e.g. created, updated, deleted).
* **Target Type** — Filter by what the action was performed on (e.g. Agent, Widget, Document).
* **Result** — Filter by outcome: Success, Failure, or Denied.
* **Date range** — Select a custom date range to focus on a specific period.

## Audit log table

Each row in the table represents a single action, displayed with the following columns:

| Column        | Description                                                                |
| ------------- | -------------------------------------------------------------------------- |
| **Timestamp** | The exact date and time the action occurred                                |
| **Actor**     | Who performed the action, with a color-coded type badge                    |
| **Action**    | What was done (e.g. "created", "updated", "deleted")                       |
| **Target**    | The specific item the action was performed on                              |
| **Result**    | Color-coded outcome: green for Success, red for Failure, yellow for Denied |

### Actor types

Actions can be performed by different types of actors, each identified by a color-coded badge:

| Actor Type | Badge Color | Description                                        |
| ---------- | ----------- | -------------------------------------------------- |
| **User**   | Blue        | A human team member performed the action           |
| **System** | Purple      | An automated platform process performed the action |
| **API**    | Orange      | The action was triggered via the API               |

## Expandable row details

Click any row to expand it and see additional information:

* **Description** — A human-readable summary of what happened.
* **Metadata** — Key-value pairs providing additional context, such as changed field names, previous values, or related entity IDs.

## Actions tracked

The Audit Log records actions across every major area of the platform, organized by category:

<AccordionGroup>
  <Accordion title="Agent actions" icon="robot">
    * **created** — A new agent was created.
    * **updated** — Agent settings were modified (e.g. model, tone, response length).
    * **published** — An agent was published and made active.
    * **archived** — An agent was archived and removed from active use.
    * **deleted** — An agent was permanently deleted.
    * **guidance\_updated** — Guardrails or guidance settings were changed.
  </Accordion>

  <Accordion title="Widget actions" icon="window-maximize">
    * **created** — A new widget was created.
    * **updated** — Widget settings were modified (e.g. style, tabs, domain restrictions).
    * **deleted** — A widget was deleted.
  </Accordion>

  <Accordion title="Deployment actions" icon="rocket">
    * **created** — A new deployment was created.
    * **updated** — Deployment settings were modified.
    * **published** — A deployment was published and made active.
    * **deleted** — A deployment was deleted.
  </Accordion>

  <Accordion title="Document actions" icon="file">
    * **uploaded** — A document was added to an agent's knowledge base.
    * **updated** — A document's details were modified.
    * **deleted** — A document was removed from the knowledge base.
    * **reindexed** — A document was reprocessed and re-indexed.
    * **URL added** — A URL source was added to the knowledge base.
  </Accordion>

  <Accordion title="Resource actions" icon="file-arrow-down">
    * **uploaded** — A resource file was uploaded.
    * **created** — A resource link was created.
    * **deleted** — A resource was removed.
  </Accordion>

  <Accordion title="Adverse event actions" icon="triangle-exclamation">
    * **config updated** — Adverse event monitoring configuration was changed.
    * **status updated** — An adverse event's review status was updated (individually or in bulk).
    * **reviewed** — An adverse event was reviewed and notes were added.
    * **closed** — An adverse event was closed.
    * **exported** — Adverse event data was exported (CSV or regulatory format).
  </Accordion>

  <Accordion title="Topic actions" icon="tags">
    * **created** — A new topic was created (individually or in bulk from templates).
    * **updated** — A topic's keywords or settings were modified.
    * **deleted** — A topic was removed.
  </Accordion>

  <Accordion title="Testing actions" icon="vial">
    * **created** — A new batch test was created.
    * **deleted** — A batch test was deleted.
    * **duplicated** — A batch test was duplicated.
    * **questions added / deleted** — Questions were added to or removed from a test.
  </Accordion>

  <Accordion title="Feedback actions" icon="comment-dots">
    * **submitted** — A widget visitor submitted feedback on an agent response.
  </Accordion>

  <Accordion title="User actions" icon="users">
    * **invited** — A new team member was invited to the organization.
    * **removed** — A team member was removed from the organization.
    * **role changed** — A team member's role was updated.
  </Accordion>

  <Accordion title="Settings actions" icon="gear">
    * **updated** — Organization or platform settings were modified.
  </Accordion>
</AccordionGroup>

## Exporting the audit log

Click the **Export CSV** button to download audit log data. Exports can include up to **10,000 events** based on your current filters.

<Tip>
  Apply filters before exporting to keep the CSV focused and manageable. For compliance audits, use the date range filter to pull events for the specific reporting period.
</Tip>

## Common use cases

<CardGroup cols={2}>
  <Card title="Compliance audits" icon="clipboard-check">
    Track who made changes to agent guardrails, adverse event settings, or other compliance-critical configuration. Export the log for external audit purposes.
  </Card>

  <Card title="Change investigation" icon="magnifying-glass">
    If an agent's behavior changes unexpectedly, use the audit log to trace recent modifications and identify the cause.
  </Card>

  <Card title="Access monitoring" icon="user-shield">
    Review user actions to ensure appropriate access and usage patterns across your team.
  </Card>

  <Card title="System activity" icon="server">
    Monitor automated system actions such as document reindexing or scheduled processes.
  </Card>
</CardGroup>
