Skip to main content
GET
/
v1
/
automations
/
runs
Get automation runs
curl --request GET \
  --url https://brew.new/api/v1/automations/runs \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "automationRunId": "run_01HZ",
      "automationId": "auto_abc",
      "automationVersionId": "av_v2",
      "triggerInstanceId": "tin_8f2k",
      "mode": "live",
      "status": "completed",
      "recipientEmail": "jane@example.com",
      "startedAt": "2026-04-08T12:34:56.789Z",
      "completedAt": "2026-04-08T12:35:10.120Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "cursor": null,
    "hasMore": false
  }
}

Authorizations

​
Authorization
string
header
default:Bearer brew_your_api_key
required

Send your Brew API key as Authorization: Bearer brew_xxx.

Query Parameters

​
automationRunId
string

Fetch a single run by id (detail mode → { data: [row] }). Omit to list.

Required string length: 1 - 64
​
include
enum<string>

Detail-only expansion: logs inlines the per-node execution logs. Rejected without automationRunId.

Available options:
logs
​
automationId
string
Required string length: 1 - 64
​
triggerEventId
string
Required string length: 1 - 256
​
triggerInstanceId
string
Required string length: 4 - 64
​
recipientEmail
string<email>
​
status
enum<string>
Available options:
pending,
running,
completed,
failed,
cancelled
​
mode
enum<string>
Available options:
live,
test
​
from
string<date-time>
​
to
string<date-time>
​
limit
integer
Required range: 1 <= x <= 100
​
cursor
string
Required string length: 1 - 256

Response

A page of runs.

​
data
object[]
required
​
pagination
object