---
title: "Read one Google review Hive is working on: its stored workflow status, who it is assigned to, its labels and its reply history, plus the live review text when the Google connection can be read. When it cannot, the result says why instead of leaving the words out silently."
method: POST
path: "/api/v1/tools/read_review"
---

# Read one Google review Hive is working on: its stored workflow status, who it is assigned to, its labels and its reply history, plus the live review text when the Google connection can be read. When it cannot, the result says why instead of leaving the words out silently.

`POST /api/v1/tools/read_review`

## Request

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

## Request body

- object
  - `reviewName` string, required: The Google review name, as read_reviews returns it.

## 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)