---
title: "Read the recent runs of one Hive automation with their outcomes and counts, and, when Hive stored an incoming event that started nothing, one plain line saying why it did not fire."
method: POST
path: "/api/v1/tools/read_automation_results"
---

# Read the recent runs of one Hive automation with their outcomes and counts, and, when Hive stored an incoming event that started nothing, one plain line saying why it did not fire.

`POST /api/v1/tools/read_automation_results`

## Request

- Base URL: `https://hivepublish.com`
- URL: `https://hivepublish.com/api/v1/tools/read_automation_results`
- Auth: HTTP bearer

## Request body

- object
  - `flowId` string, required: The Hive automation id.
  - `limit` number: How many recent runs to return, from 1 to 100.

## Response `200`

Tool result

- ToolResult
  - `data` unknown, required
  - `meta` object, required
    - `tool` string
    - `workspaceId` string, uuid

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid credential
- `403`: Missing workspace scope, role permission, or plan entitlement
- `409`: Idempotency conflict, replay, or request still in progress
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/hivepublish/apis/hive-developer-api.md) · [All operations](https://skmtc.dev/hivepublish/apis/hive-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hivepublish/apis/hive-developer-api/revisions/b440c763583e?raw)