---
title: "Add Agent Counsel Comment"
method: POST
path: "/agent-loop/internal/agent-counsel/comment"
tags: ["agent-counsel", "agent-counsel-internal"]
---

# Add Agent Counsel Comment

`POST /agent-loop/internal/agent-counsel/comment`

Delegated quote-anchored comment write for an agent-counsel reviewer.

Agent-service calls this with its agent JWT instead of writing to hocuspocus
directly; fastapi signs the HMAC envelope and relays. The author is the
reviewer named in the verified JWT — never request input — so the agent cannot
comment as anyone else. Authorized by the cap plus an open ReviewRequest for
(reviewer_id, snapshot_id), matching the context route; refuses once the review
is finished or cancelled.

## Headers

- `authorization` string, nullable

## Request body

- AgentCommentBody — A quote-anchored review comment from a synthetic reviewer.
  - `quote` string, required
  - `body` string, required
  - `context_before` string, nullable
  - `context_after` string, nullable

## Response `200`

Successful Response

- AgentCommentResponse
  - `thread_id` string, required
  - `resolved_anchor_text` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/tryscott/apis/one-shot-api.md) · [All operations](https://skmtc.dev/tryscott/apis/one-shot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryscott/one-shot-api/revisions/28bdface01df/schema)