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

# Activity events

> Every event Auxilian records in a project's activity log, with its details.

Auxilian writes an activity event in the same transaction as the change it describes. If the change is rolled back, so is the event, so the log never shows a change that didn't happen.

## Event fields

| Field | Description |
| - | - |
| Action | The event type, from the table below |
| Surface | `web` or `mcp` |
| Actor | The user who acted. For `mcp`, the user who approved the AI assistant. |
| Details | A small JSON object, described per action below |
| Created at | Server time of the change |

## Actions

| Action | Details | Example details |
| - | - | - |
| `project.created` | `name` | `{"name": "Reading list"}` |
| `table.created` | `table` | `{"table": "books"}` |
| `table.dropped` | `table` | `{"table": "scratch_import"}` |
| `column.added` | `table`, `column` | `{"table": "books", "column": "finished_on"}` |
| `column.dropped` | `table`, `column` | `{"table": "books", "column": "details"}` |
| `insert_rows` | `table`, `count` | `{"table": "books", "count": 3}` |
| `update_rows` | `table`, `count` | `{"table": "books", "count": 1}` |
| `delete_rows` | `table`, `count` | `{"table": "contacts", "count": 4}` |
| `member.invited` | `email`, `permission` | `{"email": "grace@example.com", "permission": "read"}` |
| `member.revoked` | `email` | `{"email": "grace@example.com"}` |
| `write.denied` | `tool`, `reason` | `{"tool": "insert_rows", "reason": "ACCESS_DENIED"}` |

## Notes

* Row events record counts, not values. The log doesn't keep copies of your data.
* `update_rows` and `delete_rows` events are recorded even when no rows matched, with `count: 0`.
* `write.denied` is recorded when someone without write access, or with a read-only connection, tries to change an existing project. The `tool` names the attempted operation, such as `insert_rows`, `create_table`, `share`, or `revoke`.
* Rows removed by `cascade` foreign keys are counted only in the `delete_rows` event of the table you deleted from.
* Changes to workspaces, such as invitations and role changes, aren't project events and don't appear in project activity logs.

## Retention

Events are deleted after 90 days. Deleting a project deletes all of its events. Events stay in the log after the actor deletes their account, until they age out.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.