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

# Action log

> The record of changes made to your holdings and cash.

The **Actions** page lists a row for each change you record, newest first: the symbol, shares, price per share and trade value, and cash movements as `$CASH`.

A row is a record of what you entered, not a ledger Allocait balances against. Allocait works from current share counts, so the log is not a complete history of what you held.

## What a row carries

* **Scenario label.** A holdings change records the name of the portfolio's active scenario, as text, at the time of the change. It isn't a link, so renaming the scenario later doesn't change old rows. A cash movement carries no scenario.
* **Comments.** Open a row to add or edit a comment, such as why you made the change. A comment changes no amount.

## Delete a row

**Delete action** removes the row and nothing else. It does not change any holding or cash, so it doesn't undo the change. Deleting is permanent.

## From an agent or code

| Job | MCP tool | REST |
| - | - | - |
| Comment on a row | `save_action_comment` | `PATCH /actions/{id}` |
| Delete rows | `delete_actions` | `DELETE /actions` |

See [Action and feedback tools](https://docs.allocait.app/claude/tools/actions-feedback.md).

## Next steps

> [card] [Update holdings](https://docs.allocait.app/guides/update-holdings.md)
>
> Record a change in the app.

> [card] [Update with an agent](https://docs.allocait.app/guides/update-with-an-agent.md)
>
> Record a change through MCP or REST.


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