Draft reviews

Set or clear a Brainstorming Review feedback stance. When countAgentSignals is enabled, registered agent aliases can provide independent signals.

post/api/v1/draft-reviews/{sessionId}/comments/{threadId}/feedback

Request

  • Base URL: https://commentary.dev
  • URL: https://commentary.dev/api/v1/draft-reviews/{sessionId}/comments/{threadId}/feedback
  • Auth: HTTP bearer

Path parameters

sessionIdstring required

Draft review or Research session id.

threadIdstring required

Review thread id.

Headers

X-Commentary-Workspace-Idstring

Must match the credential workspace. This header cannot widen grant authority.

X-Correlation-Idstring

Request body

signal'agree' | 'object' | 'blocker' | 'needs_clarification' | 'addressed' required

agree, object, blocker, and needs_clarification are exclusive reviewer stances per actor and thread. addressed is owner-only and clears unresolved feedback.

activeboolean
agentAliasstring nullable
clientNamestring nullable

Response

Successful response.

okunknown
threadIdstring
commentIdstring
statusstring

Changes

No recorded changes to this operation across all 1 revision of this API.