---
title: "Report a reviewer-owned hook signal"
method: POST
path: "/api/v1/reviews/{reviewSessionID}/activity"
tags: ["reviews"]
---

# Report a reviewer-owned hook signal

`POST /api/v1/reviews/{reviewSessionID}/activity`

## Path parameters

- `reviewSessionID` string, required — Reviewer session identifier, currently the per-harness review row id.

## Request body

- SetReviewActivityRequest
  - `agentSessionId` string — Native reviewer session identifier used to resume its transcript.
  - `event` string — AO hook sub-command that produced this signal.
  - `launchId` string — AO process generation that produced the signal.
  - `state` 'active' | 'idle' | 'waiting_input' | 'blocked' | 'exited' — Reviewer activity state reported by a hook. Accepted for forward compatibility, not used for session display state.

## Response `200`

OK

- SetReviewActivityResponse
  - `ok` boolean, required
  - `reviewSessionId` string, required

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error
- `501` — Not Implemented

---

[API](https://skmtc.net/composiohq/apis/agent-orchestrator-http-daemon.md) · [All operations](https://skmtc.net/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/agent-orchestrator-http-daemon/revisions/6ffec0ec12f0/schema)