---
title: "Add AI agent review item comment"
method: POST
path: "/api/v1/aiAgents/admin/review-items/{fingerprint}/comments"
---

# Add AI agent review item comment

`POST /api/v1/aiAgents/admin/review-items/{fingerprint}/comments`

Add a comment to an AI agent review item

## Path parameters

- `fingerprint` string, required

## Request body

- CreateAiAgentReviewItemComment
  - `body` string, required

## Response `200`

Success

- ApiAiAgentReviewItemActivityResponse
  - `results` AiAgentReviewItemActivity, required
    - `verdictStale` boolean, required — True when the PR changed after the latest verdict — derived from event ordering (latest pr_opened/pr_updated/writeback_completed occurred after the latest verification_completed). Drives the "Retest" prompt.
    - `liveMessage` string, nullable, required — Streaming progress text for the live row (writeback step messages).
    - `liveState` 'writeback' | 'compiling' | 'verifying', required — The in-flight step of a remediation, derived from current status + which events exist — never stored. Renders as the single accented "live" row.
    - `events` AiAgentReviewActivityEvent[], required
      - union — One row of the merged issue activity feed.
        - object
          - `kind` 'remediation', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `remediationUuid` string, nullable, required
          - `uuid` string, required
          - `payload` object, required
            - `sourcePromptUuid` string, nullable, required
            - `sourceThreadUuid` string, nullable, required
            - `excerpt` string, nullable, required
          - `eventType` 'finding_opened', required
        - object
          - `kind` 'remediation', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `remediationUuid` string, nullable, required
          - `uuid` string, required
          - `payload` object, required
            - `deletions` number, double, nullable, required
            - `additions` number, double, nullable, required
            - `files` string[], required
          - `eventType` 'writeback_completed', required
        - object
          - `kind` 'remediation', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `remediationUuid` string, nullable, required
          - `uuid` string, required
          - `payload` object, required
            - `prNumber` number, double, nullable, required
            - `prUrl` string, required
          - `eventType` 'pr_opened', required
        - object
          - `kind` 'remediation', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `remediationUuid` string, nullable, required
          - `uuid` string, required
          - `payload` object, required
            - `prUrl` string, nullable, required
          - `eventType` 'pr_updated', required
        - object
          - `kind` 'remediation', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `remediationUuid` string, nullable, required
          - `uuid` string, required
          - `payload` object, required
            - `previewProjectUuid` string, required
          - `eventType` 'preview_compiled', required
        - object
          - `kind` 'remediation', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `remediationUuid` string, nullable, required
          - `uuid` string, required
          - `payload` object, required
            - `previewThreadUuid` string, required
          - `eventType` 'verification_completed', required
        - object
          - `kind` 'remediation', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `remediationUuid` string, nullable, required
          - `uuid` string, required
          - `payload` object, required
            - `prUrl` string, required
          - `eventType` 'pr_merged', required
        - object
          - `kind` 'remediation', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `remediationUuid` string, nullable, required
          - `uuid` string, required
          - `payload` object, required
            - `prUrl` string, required
          - `eventType` 'pr_closed', required
        - object
          - `kind` 'remediation', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `remediationUuid` string, nullable, required
          - `uuid` string, required
          - `payload` RecordStringNever, required — Construct a type with a set of properties K of type T
          - `eventType` 'resolved', required
        - object
          - `kind` 'remediation', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `remediationUuid` string, nullable, required
          - `uuid` string, required
          - `payload` object, required
            - `errorMessage` string, nullable, required
          - `eventType` 'failed', required
        - object
          - `kind` 'issue', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `fingerprint` string, required
          - `uuid` string, required
          - `payload` object, required
            - `rootCause` 'semantic_layer' | 'project_context' | 'agent_configuration' | 'product_capability' | 'runtime_reliability' | 'feedback_quality' | 'not_a_failure' | 'ambiguous', required
          - `eventType` 'created', required
        - object
          - `kind` 'issue', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `fingerprint` string, required
          - `uuid` string, required
          - `payload` object, required
            - `dismissedReason` 'not_actionable' | 'expected_behavior' | 'duplicate' | 'low_confidence' | 'other', required
            - `to` 'triage' | 'open' | 'in_progress' | 'resolved' | 'dismissed' | 'duplicate', required
            - `from` 'triage' | 'open' | 'in_progress' | 'resolved' | 'dismissed' | 'duplicate', required
          - `eventType` 'status_changed', required
        - object
          - `kind` 'issue', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `fingerprint` string, required
          - `uuid` string, required
          - `payload` object, required
            - `toUserUuid` string, nullable, required
            - `fromUserUuid` string, nullable, required
          - `eventType` 'assignee_changed', required
        - object
          - `kind` 'issue', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `fingerprint` string, required
          - `uuid` string, required
          - `payload` object, required
            - `promptUuid` string, required
            - `threadUuid` string, required
          - `eventType` 'recurred', required
        - object
          - `kind` 'issue', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `fingerprint` string, required
          - `uuid` string, required
          - `payload` object, required
            - `to` 'urgent' | 'high' | 'medium' | 'low' | 'none', required
            - `from` 'urgent' | 'high' | 'medium' | 'low' | 'none', required
          - `eventType` 'priority_changed', required
        - object
          - `kind` 'issue', required
          - `createdByUserUuid` string, nullable, required
          - `occurredAt` string, date-time, required
          - `fingerprint` string, required
          - `uuid` string, required
          - `payload` object, required
            - `body` string, required
          - `eventType` 'comment_added', required
  - `status` 'ok', required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lightdash/apis/lightdash-api.md) · [All operations](https://skmtc.net/lightdash/apis/lightdash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightdash/lightdash-api/revisions/40c933755c9a/schema)