# Action audit log

Each project's history: who created, edited, deleted, restored or purged what and when, people and MCP agents.

Source: https://ardumaker.com/en/docs/auditoria-de-acciones/

- Category: Projects and companies
- Status: Available
- Requirements: Read access to the project's History (`logs`) section
- MCP tools (Read only): `ver_logs_proyecto`, `listar_papelera`, `ver_papelera`
- MCP tools (Write or modify): `restaurar_papelera`

## What can you do with it?

Every project keeps a record of what happens inside it: who did what and when. It covers the project, stages, tasks, checklist, comments, members, linked resources, folders and attachments with their comments, project meetings and linked GitHub repos.

| Type | What it records |
| --- | --- |
| `CREATE` | Creation |
| `UPDATE` | Edit |
| `DELETE` | Logical deletion: goes to the trash and can be undone |
| `RESTORE` | Restore from the trash |
| `PURGE` | Permanent deletion |
| `VIEW` | Each person's last visit |

## When should you use it?

- To find out who changed a task or deleted an attachment.
- To review what an MCP agent did on its owner's behalf.
- To find what to restore from the [trash](https://ardumaker.com/en/docs/papelera).

## How does it work in ArduMaker?

- Entries are listed from newest to oldest, up to 500 per query (100 by default).
- Visits do not pile up one row per request: that person's last visit in the project is updated.
- If an MCP agent performed the action, the entry identifies it and its owner.
- GitHub commits do not create entries: the commit already stores author and date.

## What actually changes?

- The history lives as long as the project: a (logical) project deletion does not lose it.
- When a project is permanently purged, its history goes with it and only a permanent purge record remains, without a link to the project.

## Expected result

Each entry includes user, profile picture, action description, type, date and, when relevant, the agent's data.

## Errors and troubleshooting

- Without enough level in the `logs` section, the history is not shown.
- A deletion (`DELETE`) can still be undone; a purge (`PURGE`) cannot.

## MCP access

- `ver_logs_proyecto`: history with an optional type filter and `limit` (up to 500).
- `listar_papelera` and `ver_papelera`: what was deleted, by whom and what each deletion took along.
- `restaurar_papelera`: undoes a deletion (modifies, does not destroy).

What agents do is also recorded in their own [audit log](https://ardumaker.com/en/docs/auditoria-de-agentes). Reference: [/mcp/docs](https://ardumaker.com/en/mcp/docs).

## Related features

- [Trash](https://ardumaker.com/en/docs/papelera/)
- [Agent audit](https://ardumaker.com/en/docs/auditoria-de-agentes/)
- [Roles and permissions](https://ardumaker.com/en/docs/roles-y-permisos/)
- [Projects and kanban board](https://ardumaker.com/en/docs/proyectos-kanban/)