# Actions API

> List automations and their run history, and trigger runs, under /api/actions.

*[View this page in the Flax docs](https://flax-analytics.com/docs/api-reference/actions)*

The actions endpoints expose the trigger→effect automations configured in your org
and their run history. Listing needs the `read` scope; triggering a run needs
`write`.

## List actions

`GET /api/actions` — return the actions the service account can read.

## List action runs

`GET /api/actions/{actionId}/runs` — return the run history for an action, newest
first, including each run's status.

## Trigger a run

`POST /api/actions/{actionId}/runs` — trigger the action. Requires the `write`
scope. Returns `202` with the accepted run.

```bash
curl -X POST https://flax-analytics.com/api/actions/act_123/runs \
  -H "Authorization: Bearer flax_pat_..."
```

## Related

- [Actions](/docs/automation-ai/actions)