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

# Action

> A proposed agent action: what, with which arguments, by whom, on what.

`ctrlrun.Action` — class, defined at `src/ctrlrun/action.py:151`

```python theme={null}
class Action()
    def __init__(name: str, arguments: Mapping[str, Any], principal: Principal, resource: str | None, environment: str, action_id: str)
```

A proposed agent action: what, with which arguments, by whom, on what.

Equality and hashing follow the proposal, not the content: two Actions are equal iff
their `action_id` matches (SPEC-v0.1 §2.1). Identical content shares an `action_hash`.

## Next

* [Python API index](/reference/api/index).
* [Get started](/get-started/quickstart) · [Why](/why).


## Related topics

- [action_hash](/reference/api/action_hash.md)
- [Action and hash](/concepts/action-and-hash.md)
- [ActionDenied](/reference/api/ActionDenied.md)
- [Run verify in GitHub Actions](/cookbook/verify-in-github-actions.md)
- [Errors](/reference/errors.md)