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 rancreatedAt(string (date-time), required): When the run happeneddepth(integer, required): 1 when a person's (or another service's) change started it, n when automations started each otherdurationMs(integer, required): Duration in millisecondsid(string (uuid), required): Run idoutcome(string, required): skipped: a limit stopped it (too many automations for one event) (one ofsucceeded,failed,skipped)steps(integer, required): The number of nodes that rantriggerKind(string, required): What started it: an event or a manual start (one ofevent,manual)version(integer, required): The version of the automation that ranactorKind(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_failederrorMessage(string): Failed runs: the error textevent(string): The event type that started itnode(string): The id of the node that failedstartedBy(string): The person or actor behind the triggering changesubject(string): What the event was about: the item's id
total(integer)
Example 200 answer:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/forge/v1/projects/string/automations/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/runs' \
-H "Authorization: Bearer $ACCESS_TOKEN"