Get automation runs
Unified automation-run read. Omit automationRunId to LIST recent runs (newest first) under { data, pagination }. Filters: automationId, triggerEventId, triggerInstanceId, recipientEmail, status (pending | running | completed | failed | canceled), mode (live | test), and the from/to ISO-8601 window. Pass ?automationRunId= to fetch ONE run — returns { data: [row] } (no pagination), 404 AUTOMATION_RUN_NOT_FOUND on an unknown / cross-brand id. List + detail rows are lean by default; add ?include=logs (detail only) for the per-node execution logs[].
Authorizations
Send your Brew API key as Authorization: Bearer brew_xxx.
Headers
The brand this request acts on. REQUIRED for organization-scoped credentials (otherwise 400 BRAND_ID_REQUIRED — there is no default brand); list ids with GET /v1/brands. Brand-scoped credentials may omit it, and sending a different brand returns 403 BRAND_SCOPE_MISMATCH. A brand outside your organization returns 404 BRAND_NOT_FOUND.
1 - 64Query Parameters
Fetch a single run by id (detail mode → { data: [row] }). Omit to list.
1 - 64Detail-only expansion: logs inlines the per-node execution logs. Rejected without automationRunId.
logs 1 - 641 - 2564 - 64pending, running, completed, failed, canceled live, test 1 <= x <= 1001 - 256