## List the last executions of an automation (tenant:forge:read)

`GET /api/forge/v1/projects/{key}/automations/{id}/runs`

Module: Forge · operationId: `listForgeAutomationRuns` · Tag: Automations · Auth: access token (`Authorization: Bearer <accessToken>`)

Requires `tenant:forge:read` and a project the caller sees. Newest first; the log keeps the last 50 executions of an automation – what triggered it, the outcome, the failing node with its error, the duration.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `limit` | query | integer |  | (default `50`; max 50) |
| `key` | path | string | yes | Project key (e.g. APP) |
| `id` | path | string (uuid) | yes |  |

### Responses

- **200** The executions (`application/json`)
- **400** Error (`application/json`)
- **404** Error (`application/json`)

Fields of the 200 answer:

- `items` (array of AutomationRun, required)
  - `automationId` (string (uuid), required): The automation that ran
  - `createdAt` (string (date-time), required): When the run happened
  - `depth` (integer, required): 1 when a person's (or another service's) change started it, n when automations started each other
  - `durationMs` (integer, required): Duration in milliseconds
  - `id` (string (uuid), required): Run id
  - `outcome` (string, required): skipped: a limit stopped it (too many automations for one event) (one of `succeeded`, `failed`, `skipped`)
  - `steps` (integer, required): The number of nodes that ran
  - `triggerKind` (string, required): What started it: an event or a manual start (one of `event`, `manual`)
  - `version` (integer, required): The version of the automation that ran
  - `actorKind` (string): Who made the triggering change (person, integration, assistant, automation, system, scm)
  - `errorCode` (string): Failed runs: the stable code, e.g. `transition_not_allowed`, `invalid`, `out_of_scope`, `expression`, `invalid_definition`, `action_failed`
  - `errorMessage` (string): Failed runs: the error text
  - `event` (string): The event type that started it
  - `node` (string): The id of the node that failed
  - `startedBy` (string): The person or actor behind the triggering change
  - `subject` (string): What the event was about: the item's id
- `total` (integer)

Example 200 answer:

```json
{
  "items": [
    {
      "actorKind": "person",
      "automationId": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e01",
      "createdAt": "2026-10-28T15:00:02Z",
      "depth": 1,
      "durationMs": 14,
      "event": "forge.item.children_done",
      "id": "0d1e2f3a-4b5c-4d6e-9f7a-8b9c0d1e2f01",
      "outcome": "succeeded",
      "startedBy": "marie.wagner@muster-it.example",
      "steps": 1,
      "subject": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c02",
      "triggerKind": "event",
      "version": 2
    },
    {
      "actorKind": "person",
      "automationId": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e01",
      "createdAt": "2026-11-12T12:00:01Z",
      "depth": 1,
      "durationMs": 9,
      "errorCode": "transition_not_allowed",
      "errorMessage": "the workflow does not allow the move to erledigt",
      "event": "forge.item.children_done",
      "id": "0d1e2f3a-4b5c-4d6e-9f7a-8b9c0d1e2f02",
      "node": "erledigen",
      "outcome": "failed",
      "startedBy": "marie.wagner@muster-it.example",
      "steps": 1,
      "subject": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c05",
      "triggerKind": "event",
      "version": 2
    }
  ],
  "total": 2
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/forge/v1/projects/string/automations/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/runs' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
