# list_agent_automation_runs

Source: https://modulify.ai/docs/api/agent-automations/list-agent-automation-runs

Lists recent runs of the agent automations on a site, newest first, 25 to a page.

- Title: List agent automation runs
- Scope: `config:read`
- Access: Read only
- Endpoint: `POST /v1/list_agent_automation_runs`

Each run shows its status, when it was scheduled, who started it when it was run by hand, its report or its error, the tools it called and whether each call worked, whether the report was emailed, and the credits it has charged so far. A run interrupted on Modulify's side, stopped because the AI model did not answer, or out of credits says so in its error and does not count as a failed run.

The response carries `nextCursor`. Pass it back as `cursor` for the next page, and it is null once there is nothing more. Runs are kept for 30 days. See [Agents](https://modulify.ai/docs/automations/agents#run-history).

## Request

Call it with a `POST` to `https://api.modulify.ai/v1/list_agent_automation_runs`, sending the inputs below as a JSON object. The token needs the `config:read` scope.

It only reads and changes nothing, so retrying it is safe.

```bash
curl -X POST https://api.modulify.ai/v1/list_agent_automation_runs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"PROJECT_ID"}'
```

Over MCP, the same method is the [list_agent_automation_runs tool](https://modulify.ai/docs/mcp/agent-automations/list-agent-automation-runs).

## Inputs

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `projectId` | string | Yes | The site id. |
| `automationId` | string | No | Only the runs of this one automation, by its id from `list_agent_automations`. Leave it out for the runs of every automation on the site. |
| `cursor` | string | No | The `nextCursor` from the previous page. Leave it out for the first page. |

## Response

Every call answers with the [JSON envelope](https://modulify.ai/docs/api/requests-and-responses#the-response) of `success`, `message`, `data`, `code` and `version`. `data` holds the result described above, and on a method that returns a total, `count` carries it. The [response headers](https://modulify.ai/docs/api/requests-and-responses#headers-on-every-method-call) carry the call's `X-Request-Id` and what is left of your per-minute budget in `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`. [Errors](https://modulify.ai/docs/api/errors) explains every status code a call can answer with.